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PREFACE 


MANUAL OBJECTIVES 


The VAX-11/RSX-11M Programmer's Reference Manual describes VAX/VMS 
Support of RSX~11M directives. This document bridges the gaps between 
the RSX-11M/M-PLUS Executive Reference Manual and the VAX/VMS System 
Services Reference Manual; and between the RSX-11M I/0 Drivers 
Reference Manual and the VAX/VMS I/O User's Guide. 





INTENDED AUDIENCE 


This manual contains information needed by an RSX-11M programmer’ who 
is responsible for making RSX-11M Version 3.2 task images run under 
VAX/VMS. 


This document has two prerequisites: 


e Understanding of the RSX-11M operating system and executive 
directives 


e Understanding of the material presented in the VAX-11/RSX-11™M 
User's Guide 


STRUCTURE OF THIS DOCUMENT 
Information in this document is organized as follows. 


e Chapter 1 contains a general definition of VAX-11 
compatibility mode and VAX/VMS support of RSX-11M Version 3.2 
images. It also contains a general description of basic 
VAX/VMS concepts, such as process and image, and their 
relationship to an RSX-11M task. 


e Chapters 2 and 3 discuss certain VAX/VMS system components and 
explain the implications of their use for RSX-11M task images. 
Chapter 3 focuses on the use of the VAX/VMS I/0 system _ for 
RSX-11M image I/O. 


e Chapter 4 describes each RSX-11M directive as it is supported 
under VAX/VMS. 


vil 


e Chapter 5 discusses QUEUE I/O REQUEST directive function codes 
and function-dependent parameters for devices supported by 
VAX/VMS. 


e Appendix A contains the VAX-1l compatibility mode instruction 
set. Appendix B describes the VAX-11 RMS parse directive. 


ASSOCIATED DOCUMENTS 
The following documents may also be useful. 
e VAX~11 Information Directory and Index 


e VAX/VMS Primer 


e VAX/VMS System Services Reference Manual 





e@ VAX/VMS I/O User's Guide 


e VAX/VMS Summary Description and Glossary 





e VAX/VMS System Manager's Guide 





e VAX-11 Record Management Services Reference Manual 








e RSX-11M Version 3.2 document set 


CONVENTIONS USED IN THIS DOCUMENT 


This manual uses the same conventions as the RSX-11M/M-PLUS Executive 


Reference Manual, for example, brackets ([]) indicate optional 


parameters. In addition, the directive descriptions in Chapter 4 use 
shading to highlight differences in VAX/VMS Support of the directives. 
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SUMMARY OF TECHNICAL CHANGES 


The changes in VAX/VMS support of RSX-11M directives are in three 


general 
e 
e 
e 


The new 


The new 


The new 


areas: 

The addition of STOP and associated directives 

The addition of group global event flag features 

The addition of the SPAWN directive 

STOP and associated directives are: 

The STOP directive, which places the calling image into 
hibernation. This hibernation can end only on an UNSTOP TASK 
directive from another image or on an asynchronous system trap 


(AST) in the calling image. 


The UNSTOP TASK directive, which activates a given task that 
is hibernating because it issued a STOP directive. 


The STOP FOR LOGICAL OR OF EVENT FLAGS and STOP FOR’ SINGLE 
EVENT FLAG directives, which behave exactly as their wait 
counterparts (WAIT FOR LOGICAL OR OF EVENT FLAGS and WAIT FOR 
SINGLE EVENT FLAG), except that the resulting hibernation can 
end only on an UNSTOP TASK or an AST. 


The RECEIVE DATA OR STOP directive, which behaves exactly as 
its exit counterpart (RECEIVE DATA OR EXIT), except that the 
resulting hibernation can end only on an UNSTOP TASK or an 
AST. 

group global event flags features are: 


The CREATE GROUP GLOBAL EVENT FLAGS directive, which 
associates an image with given group global event flags. 


The ELIMINATE GROUP GLOBAL EVENT FLAGS directive, which 
disassociates an image from its group global event flags. 


The READ EXTENDED EVENT FLAGS directive, which retrieves’ the 
values of all flags, including group global event flags. 


facility for creating subprocesses is: 


The SPAWN directive, which creates a subprocess and _ begins 
executing a given image in that subprocess. 
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These nine directives are described in detail in Chapter a 
Stop-driven hibernation, group global event flags, and subprocesses 
are described in detail throughout Chapters 2 and 3. 


NOTE 


The CONNECT directive is not supported 
under VAX/VMS Version 2.0. 


CHAPTER 1 


INTRODUCTION 


Compatibility mode is a processor state that allows PDP-11 programs to 
execute under the VAX-11l processor. For compatibility mode execution 
to occur, the needs of the program must be satisfied on two levels: 


e At the hardware instruction set level 
e At the level of program interface to the operating system 


At the hardware level, the VAX-11 processor includes an _ instruction 
set that is a compatible subset of the PDP-11 instruction set. This 
compatibility mode instruction set provides a general basis’ that 
potentially allows any PDP-1ll user mode program to execute using the 
VAX-11 hardware. 


In addition, VAX/VMS supplements the subset of PDP-1l instructions 
that can be used in compatibility mode through software emulation of 
the FPP floating-point instructions; FIS floating-point instructions 
are not emulated. : 


Because of the two instruction sets, the VAX-1l processor has_ two 
basic modes of operation: native and compatibility. The processor is 


in native mode to execute native mode instructions and in 
compatibility mode to execute compatibility mode instructions. 
Software controls the processor mode. Thus, when a compatibility 


program has been prepared for execution, VAX/VMS places the processor 
in compatibility mode just before passing control to the program. 
VAX/VMS accomplishes this in a manner that is transparent to the user. 


When an RSX-11M task image executing in VAX-11 compatibility mode 
attempts to interface with the operating system, a hardware-generated 
trap occurs. Hardware-generated traps are the mechanism by which’ the 
processor notifies VAX/VMS that emulation of the RSX-11M operating 
system's environment is required. The occurrence of a compatibility 
mode trap automatically places the processor in native mode. 


Executing in native mode, VAX/VMS duplicates the RSX-11M task/system 
interface. VAX/VMS returns to the task in compatibility mode to allow 
the task to continue execution. 


For example, RSX-11M tasks use EMT377 instructions to interface with 
the operating system. An attempt to execute an EMT377 instruction on 
VAX-11 hardware causes a trap to VAX/VMS. VAX/VMS then emulates’ the 
requested service in native mode, places the processor in 
compatibility mode, and returns to the task. The task continues 
execution in compatibility mode. 
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The VAX-11 system provides compatibility mode capabilities to support 
the migration of task images from RSX-11M operating systems to 
VAX/VMS. Compatibility mode provides a framework in which users’ can 
run existing task images while upgrading to take full advantage of 
VAX/VMS native capabilities. 


The VAX-11 system also provides facilities for developing RSX-11M 
tasks. See the VAX-11/RSX-11M User's Guide. 





Compatibility mode programs requiring floating-point instruction 
emulation do not run as fast under VAX/VMS aS on ae PDP-1l. 
Compatibility mode programs not requiring floating-point emulation and 
written for a PDP-11/70 run under VAX/VMS at approximately the same 
speed as they do under the system for which they were written. 
Programs not requiring floating-point emulation and written for 
smaller PDP-11l processors run faster under VAX/VMS. 


For Version 2.0, VAX/VMS supports execution of RSX-11M Version 3.2 
nonprivileged task images in compatibility mode. The majority of 
nonprivileged, user mode RSX-11M Version 3.2 task images run under 
VAX/VMS without program modification or rebuilding. Others require 
modification. 


VAX/VMS provides the RSX-11M components (for example, MACRO-11_= and 
RSX-11M task builder) needed to make required modifications using the 
VAX/VMS system as host. Modifications also can be made using an 
RSX-11M system. 


For an RSX-11M task image to execute successfully under VAX/VMS, it 
must adhere to the requirements for compatibility mode operation. 
Both the VAX-1l and VAX/VMS define specific requirements. These 
requirements are detailed in Sections 1.1 and 1.2. 


1.1 VAX-11 COMPATIBILITY WITH PDP-115S 


VAX-11 compatibility mode supports PDP-11l user mode operations. That 
is, any PDP-11 program that operates only in user mode (not in PDP-11 
supervisor or kernel mode) potentially can run in VAX-11 compatibility 
mode. 


Any instruction or operation denied to a user mode program executing 
on a PDP-11 is not allowed in VAX-11 compatibility mode. For example, 
use of privileged instructions such as HALT and RESET is not 
permitted; an attempt to use a privileged instruction causes a trap 
to VAX/VMS, and a subsequent error message. 


The VAX-11 compatibility mode instruction set also does not’ support 
the FIS or FPP floating-point instructions; however, VAX/VMS emulates 
the FPP instructions. Appendix A of this document lists the VAX-11 
compatibility mode instruction set. 


VAX/VMS places further conditions' on the use of the hardware by 
RSX-11M task images running in compatibility mode. These conditions 
are detailed in Section 1.2. 
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1.2 VAX/VMS COMPATIBILITY WITH RSX-11M VERSION 3.2 


VAX/VMS supports the capabilities of RSX-11M Version 3.2 to allow the 
execution of RSX-11M task images. However, to run in compatibility 
mode, a task image must meet the following requirements. 


e It must adhere to the hardware requirements for compatibility 
mode. 


e It must have been built by the RSX-11M task builder, Version 
3.1 or later, or by the VAX/VMS task builder, Version 1.0 or 
later. 


e It must be executable in a mapped RSX-11M system. 


e It must not depend on environmental features of RSX-11M_ that 
are not available in VAX/VMS, such as partitions, PLAS, or 
Significant events. Environmental differences between RSX-11M 
and VAX/VMS are discussed further in Chapters 2 and 3 of this 
document. 


e It must execute within the limitations of task/executive 
interaction described in the RSX-11M_ Executive Reference 
Manual. It must not be privileged for the purpose of 
overmapping the RSX-11M executive. The RSX-11M executive is 


not present in a VAX/VMS system. 





e It must not overmap the I/0 page. The PDP-1l1 I/O page is not 
present in VAX-1l hardware. 


e It must not depend on the 32-word memory granularity of the 
KT11 memory management unit. 


RSX-11M task images must not depend on special memory management 
features available to RSX-11M privileged tasks. Tasks can, however, 
perform privileged functions that do not involve mapping of the 
executive. For example, a task executing in compatibility mode can 
use the QIOS function codes IO.RLB and IO.WLB to read directly from 
and write directly to a mounted volume if the system manager has not 
restricted the user from so doing. 


Task images that are developed under RSX-11D or IAS and that are 
compatible with RSX-11M can execute under VAX/VMS if they meet the 
requirements listed above. However, such task images must be rebuilt 
using the RSX-11M Version 3.2 task builder. RSX-11M task images do 
not have to be rebuilt to run under’ VAX/VMS unless program 
modification or different task builder options are required. 


1.3 RSX-11M DIRECTIVE REQUESTS 


In RSX-11M, a task image interfaces with the operating system by 
issuing directive requests. As a result of a directive request, 
RSX-11M performs the desired function and returns control to the task. 
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VAX/VMS duplicates this task/system interaction. When an RSX-11M task 
image issues a directive, the hardware traps to VAX/VMS. With the 
exception of the RSX-11M memory management (PLAS) directives described 
in Section 1.4, VAX/VMS duplicates the requested RSX-11M function with 
either of the following results. 


e The RSX-11M directive function is duplicated in VAX/VMS, and 
the image continues execution. 


@ VAX/VMS cannot duplicate the requested function but does’ take 
whatever action is necessary to allow the task to continue 
execution. 


VAX/VMS duplicates the functions of most RSX-11M directives. When 
VAX/VMS cannot duplicate an RSX-11M directive, it is because of 
differences in the basic concepts of the two systems, that is, 
differences in the environments of the two systems. 


For example, the RSX-11M capability to declare a significant event 
does not exist in VAX/VMS; therefore, VAX/VMS cannot declare one upon 
directive request. Rather, it performs no operation and returns a 
success status to the requesting task image, which continues execution 
normally. 


Subsequent chapters of this document describe the details and 
implications of directive handlng in VAX/VMS. 


1.4 OVERLAYS, SHAREABLE REGIONS, MULTIUSER TASK IMAGES, AND PLAS 


VAX/VMS supports the use of overlays produced using the overlay 
descriptor language of the RSX-11M task builder by RSX-11M images. 
VAX/VMS loads overlays from the image file at the appropriate point in 
image execution. 


VAX/VMS also supports use of shared regions by RSX-11M images. 
RSX-11M images can access both shared commons and libraries. 
Permanently available shared regions are identified to VAX/VMS by the 
System manager, as described in the VAX/VMS System Manager's Guide. 
Temporary regions are dynamically loaded when an image requiring them 
executes. 


In addition, VAX/VMS supports multiuser (shareable) task images. That 
is, when a task image is specified at task build time as consisting of 
a shareable and nonshareable portion, VAX/VMS allows multiple users to 
access the shareable portion simultaneously. Each user has a private 
copy of the nonshareable portion. 


VAX/VMS does not support the RSX-11M memory management directives that 
extend the program logical address space (PLAS) of an RSX-11M task. 
Any task image issuing a memory management directive under VAX/VMS 
receives an error Status return. 


1.5 EMULATION OF FLOATING-POINT INSTRUCTIONS 


VAX/VMS provides software emulation of the PDP-11 FPP floating-point 
instructions for images running in compatibility mode. The time 
required for emulation of an ADDF (register to register) or ADDF 
(memory to register) is approximately 25 times that required on a 
PDP-11/70. This timing is typical of most FPP instructions emulated. 
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Results produced during emulation are the same as those produced by 
PDP-11 processors with the following two exceptions: 


1. The result of a MOD instruction iS more accurate under 
emulation. 


2. On overflow, the emulator generates a reserved operand with a 
value of zero, rather than providing the residue. 


The FPP instruction set is detailed in the PDP-11/70 Processor 
Handbook. 


1.6 VAX/VMS SYSTEM CONCEPTS 


In VAX/VMS, the concept of an RSX-11M task is separated into its _ two 
basic components: the program image that executes, and the control 
information and virtual address space required for image execution. 
These two components correspond to the VAX/VMS concepts of image and 
process, respectively. The concepts of image and process are basic to 
VAX/VMS. 


A process is the basic schedulable program entity that the VAX-11 
processor executes. A process consists of a virtual address space and 
control information that both the hardware and software require, such 
as saved register contents and status information. This control 
information is called the process context. 


An image is the result of linking one or more object modules together. 
An image can be linked by the VAX-11 linker to execute in native mode 
or by the RSX-11M task builder to run in compatibility mode. An image 
executes in the virtual address space provided by a process and under 
control of the process, 


A process's virtual address space is divided into two. areas: the 
program region and the control region as illustrated in Figure 1-1. 
Essentially, the program region provides virtual memory for an image. 
The control region contains information required by the system to 
control the process. 


The concept of a process with an image is similar to the RSX-11M 
concept of a task. The main difference is that a task is a form of 
process that executes a specific image while a process can execute any 
image. Furthermore, a process remains to execute subsequent images 
when the current image exits. 


In RSX-11M, a reference to a specific task also implies a specific 
reference to an image. This is not the case with VAX/VMS; therefore, 
it is useful to state explicitly whether an operation affects a 
process or its image. For this reason, the terms process and image 
are used throughout this document instead of the term task. 


The VAX-11 Technical Summary further explains the concepts of process 
and image. 
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Program Region 


RSX-11M images run in this region. 


Control Region 





Figure 1-1 Proccess Virtual Address Space 


1.7 DISTINCTION BETWEEN PROGRAMMING AND SYSTEM ENVIRONMENTS 


VAX/VMS provides RSX-11M images with an environment similar to that 
provided by RSX-11M. That is, when an RSX-11M image is loaded, it has 
a virtual address space starting at location 0. It has access to a 
copy of its task header in the usual place, and RO through R7 are 
initialized as they are under RSX-11M. This environment allows’ the 
creation, assembly or compilation, linking, execution, and debugging 
of RSX-11M images. VAX/VMS does not, however, attempt to duplicate 
the total environment of the RSX-11M operating system. 


For information about developing RSX-11M tasks on VAX/VMS, see_ the 
VAX-11/RSX-11M User's Guide. 


Certain aspects of the RSX-11M environment have direct equivalents in 
the VAX/VMS' environment. An RSX-11M task name, for example, can be 
considered a VAX/VMS process name; and RSX-11M event flags can _ be 
translated to VAX/VMS event flags. 


When a VAX/VMS process executes an RSX-11M image, VAX/VMS receives the 
traps and exceptions caused by that image and interprets them as 
RSX-11M would. VAX/VMS then makes a response that is appropriate for 
the VAX/VMS'- environment. For example, I/O and send/receive data 
operations become appropriate VAX/VMS functions. 


Other aspects of RSX-11M equate to similar VAX/VMS- functions. For 
example, both systems use user identification codes (UICS). In 
RSX-11M, UICS are account (login) identifiers, provide a default user 
file directory (UFD), and are used for file protection. In VAX/VMS, 
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the concept of UIC is separated from those of account identifier and 
default directory name. Rather, the UIC concept is expanded in the 
direction of additional protection, as described in Section 2.2. 


Finally, some aspects of RSX-11M have no counterpart in VAX/VMS. 
Because no parallel function exists in VAX/VMS, VAX/VMS~ cannot 
translate functions associated with those concepts to VAX/VMS 
functions, Examples of RSX-11M system environment aspects not 
emulated under VAX/VMS are partitions, significant events, and a range 
of priorities from 1 through 250. Although VAX/VMS does not duplicate 
these RSX-11M features, it does accept image requests related to’ them 
and takes an appropriate action to allow image execution to continue. 


CHAPTER 2 


THE VAX/VMS SYSTEM ENVIRONMENT 


The environment that VAX/VMS' provides for an RSX-11M image is 
determined by two factors: 


1. The privileges, UIC, and resource usage limits allotted to 
the user who initiates the image 


2. The VAX/VMS system components and conventions used to support 
RSX-11M directives requested by the image 


2.1 PRIVILEGES 


The system manager maintains a user authorization file that contains 
an entry for each user. That entry includes a list of the privileges 
allowed that user's process. All of the privileges that can be 
associated with a process are described in the VAX-11/RSX-11M User's 
Guide. 


VAX/VMS returns the RSX-11M DSW return code IE.PRI to an RSX-11M image 
requesting a function for which it does not have the appropriate 
privilege. The individual directive descriptions in Chapter 4 
indicate the DSW codes returned for each directive. 


2.2 UIC-BASED PROTECTION 


In VAX/VMS, each process has an associated UIC. The UIC consists of 
32 bits (1 longword). The member code is in bits 0 through 15 and the 
group code is in bits 16 through 31, as illustrated in Figure 2-l. 


31 16 15 0 


Group Member 


Figure 2-1 Format of VAX/VMS UICs 


VAX/VMS uses a process's UIC, with the privileges assigned to it by 
the system manager, to control access to the system services that 
affect other processes in the system. 


When an RSX-11M image issues a directive, VAX/VMS executes’- the 
corresponding system service. If this service is. restricted by 
UIC-based protection in VAX/VMS, the group number and privileges of 
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the process executing the RSX-11M image are checked before the service 
is completed. An error status is returned if the issuing process is 
not in the appropriate group or does not have the appropriate 
privilege to affect the target process. ABORT TASK is an example of 
an RSX-11M directive restricted by UIC-based protection in VAX/VMS. 


VAX/VMS ignores the UIC specified when an RSX-11M image is built. 

An RSX-11M image can gain access to the UIC of its process by issuing 
a GET TASK PARAMETERS directive. The UIC is returned in two words of 
the GET TASK PARAMETERS buffer: 


e The low-order byte of the group code and the low-order byte of 
the member code are returned in word 7, as under RSX-11M: 


15 8 7 0 





Bits 0 through 7 
of group code 


Bits 0 through 7 
of member code 





e The high-order byte of the group code and the high-order byte 
of the member code are returned in word 15: 


15 8 7 0 


Bits 8 through 15 
of group code 


The UIC returned is for informational purposes only. The RSX-11M 
image cannot use it to affect group protection or file protection. 







Bits 8 through 15 
of member code 


An RSX-11M image cannot assume that its default account name is 
related to its UIC. VAX/VMS provides a special directive that is used 
by File Control Services (FCS) and RMS-11 to access the actual account 
name. 


2.3 RESOURCE USAGE LIMITS 


VAX/VMS controls a process's use of system resources by enforcing 
usage limits defined in the user's authorization file entry. All of 
the limits that can be defined for a process are described in the 
VAX-11/RSX-11M User's Guide. The following lists the quotas that may 


be relevant to an RSX-11M image running in VAX/VMS. 





e Number of active buffered I/O requests 
@ Number of bytes of system dynamic memory used for buffered I/0 


@e Number of active direct I/O requests 


ine) 
| 
N 
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e Number of files open simultaneously 
e Disk quotas 


By default, VAX/VMS places an RSX-11M or native image that attempts to 
exceed a resource limit in a wait state until the function can be 
accomplished without exceeding the limit (for example, until other 
active I/O requests have completed). Native images can disable and 
enable resource waiting. The DCL and MCR RUN commands’ provide an 
option for controlling resource wait mode for subprocesses’ and 
detached processes. 


If an RSX-11M image attempts to exceed a limit when resource waiting 
is disabled, the image receives a DSW code of IE.UPN (insufficient 
dynamic memory). 


2.4 PROCESS NAMES 


Each process in a VAX/VMS system has a unique 32-bit process 
identification and a process name. A process name qualified by its 
UIC is unique within a system. 


When a user initiates an RSX-11M image that has a task name in its 
image label block (that is, a task name specified at build time), 
VAX/VMS assigns the task name as the process's name during image 
initialization. That name remains in effect until the image exits. 
Then, VAX/VMS restores the process name used prior to execution of the 
RSX-11M image. Because VAX/VMS does not incorporate the concept of an 
installed task, an RSX-11M image cannot acquire a task name by any 
means other than task building. 


An RSX-11M image must have a task name in its label block to provide a 
name for its process if any of the following is to occur: 


e The image is to receive data using the RECEIVE DATA, RECEIVE 
DATA OR EXIT, or RECEIVE DATA OR STOP directives 


e The image is to cooperate with other images using event flags 


e The process containing the image is to be the target of 
directive action, for example, is to be requested or resumed 


Each of the following RSX-11M directives accepts a task name as an 
argument. 


@e ABORT TASK 

e CANCEL TIME BASED INITIATION REQUESTS 

e REQUEST TASK 

@ RESUME TASK 

@ RUN TASK 

@e SEND DATA 
VAX/VMS supports the RSX-11M convention of naming multiuser MCR- tasks 
with a string that starts with three periods, for example, ...PIP. 
When VAX/VMS encounters an image with a task name of this type, it 


recognizes that the image can be run by more than one user 
Simultaneously. For such images, VAX/VMS does not create a process 


THE VAX/VMS SYSTEM ENVIRONMENT 


name from the task name or set up the mechanisms for it to receive 
data from other processes and to synchronize with other processes 
using event flags. 


If an RSX-11M image is to issue directives that specify a process 
executing a native image as the target, the user must be aware of the 
difference in the allowable lengths of task names and process names. 


A task name has a maximum length of six characters. A process name 
has a maximum length of 15 characters. Therefore, if an RSX-11M image 
is to refer to a process running a native image, that process's name 
must not exceed six characters. An RSX-11M image cannot express a 
process name that exceeds six characters. 


A process running a native image can create a subprocess or a detached 
process, assign it a process name, and designate an image that the 
process is to execute. Thus, a procesS can create a named subprocess 
or detached process that executes an RSX-11M image. Once the process 
is created, other processes can issue system service requests in 
native mode or directive requests in compatibility mode that designate 
the process as the target. The creator of a subprocess always is 
allowed to affect the subprocess. Other processes and subprocesses 
must have either group or world privilege to affect the subprocess. 


Subprocess and detached process creation are described in the VAX/VMS 
System Services Reference Manual. 


2.5 EVENT FLAG CLUSTERS 


An RSX-11M task can have up to three event flag clusters of 32 bits 
each. VAX/VMS emulation of these event flags is completely 
transparent to RSX-11M task images. The event flag clusters are: 


e Local event flags, numbered 1 through 32 
e Common event flags, numbered 33 through 64 
e Group global event flags, numbered 465 through 96 


Although event flag emulation is transparent to RSX-11M task images, 
the handling of these flags is important to interactions between 
native VAX/VMS processes and RSX-11M task images. A native VAX/VMS 
process cannot associate with any common or group global event flag 
cluster outside its UIC group. 


Local event flags (flags 1 through 32) are visible only to the _ local 
task image. A task image can both read and set its local event flags. 


Every task image is associated with its local event flag cluster. A 
native VAX/VMS proceSsS cannot associate with the local event flag 
cluster for an RSX-11M task image. 


Common event flags (flags 33 through 64) are visible to all processes 
associated with the flag cluster. Any process can read and set flags 
in its associated common event flag cluster. 


The name of a common event flag cluster is RSXCOMEFN. VAX/VMS 
qualifies this name with a UIC group number to protect the flags from 
processes with different UIC group numbers. Only processes with the 
correct UIC group number can associate with the common event flag 
cluster RSXCOMEFN for that UIC group. 
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An RSX-11M task image is associated with a common event flag cluster 
only if its task image label block has a task name. Otherwise, the 
task image has no common event flags. 


A native VAX/VMS process can associate with the common event flags for 
an RSX-11M task image. To do this, the process must issue the 
Associate Common Event Flag Cluster system service, giving an event 
flag number in the range 64 to 95 and giving the cluster name 
RSXCOMEFN. Note that the native process sees the common event flags 
as flags 64 through 95; an RSX-11M task image sees them as flags 33 
through 64. 


Group global event flags (flags 65 through 96) are visible to all task 
images associated with the flag cluster. Any process that is 
associated with a group global event flag cluster can read and_ set 
flags in that cluster. 


The name of a group global event flag cluster is RSXGROUPEFN. VAX/VMS 
qualifies this name with a UIC group number to protect the flags from 
processes with different UIC group numbers. Only processes with the 
correct UIC group number can associate with the group global event 
flag cluster RSXGROUPEFN for that UIC group. 


An RSX-11M task image is associated with a group global event flag 
cluster only if it has issued a CREATE GROUP GLOBAL EVENT FLAGS 
directive for the cluster. Otherwise, the task image has no- group 
global event flags. 


A native VAX/VMS process can associate with a group global event flag 
cluster for an RSX-11M task image. To do this, the process must issue 
the Associate Common Event Flag Cluster system service, giving an 
event flag number in the range 96 to 127 and giving the cluster name 
RSXGROUPEFN. Note that the native process sees the common event flags 
as flags 96 through 127; an RSX-11M task image sees them as flags 45 
through 96. 


In summary, event flag conversion for a VAX/VMS process is as follows: 


Cluster RSX-11M VAX/VMS 

Local 1 through 32 32 through 63 
Common 33 through 64 64 through 95 
Group global 65 through 96 96 through 127 


2.6 SYSTEM STATUS CODES 


In VAX/VMS, the symbolic name for a system service status return has 
the following format. 


SS$_name 


When an image issues an RSX-11M directive, VAX/VMS attempts to emulate 
the desired function and then returns a DSW code to indicate success 
or failure to the image. In most cases, VAX/VMS calls the system 
service that performs the equivalent of the requested RSX-11M function 
and converts the status code returned by the service to the equivalent 
RSX-11M DSW code. For example, the VAX/VMS code SSS NORMAL becomes 
DSW code IS.SUC. ~ 
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In some cases, however, a directive request results in a VAX/VMS error 
for which no exact RSX-11M equivalent exists. This situation occurs 
when an image attempts to violate a VAX/VMS concept that has no 
RSX-11M equivalent. VAX/VMS handles the situation in one of the 
following ways. 


e By returning a default DSW code 


e By returning a DSW code that is meaningful for the error’ but 
that could not be returned for the directive if the image 
were running under RSX-11M 


Default return codes are used when no clear one-to-one relationship 
exists between VAX/VMS and RSX-11M codes; for example, a VAX/VMS code 
that is equally related to two DSW codes. 


A new DSW code is returned when a VAX/VMS error has no counterpart in 
RSX-11M. An example is IE.PRI which indicates that the image 
attempted to issue a directive for which its process does not have the 
appropriate privilege. For example, the image attempted to resume 
another process in its group but does not have group privilege. 


In some cases after a directive failure, VAX/VMS returns an error code 
in the DSW that is more meaningful to I/O operations. In these cases, 
the high-order byte of the DSW contains 0. The DSW codes IE.PRI- and 
IE.DUN (for ASSIGN LUN) are examples of codes that are returned as 
bytes rather than words. RSX-11M images can determine whether a DSW 
code is returned as a byte or word by testing the high-order byte of 
the DSW for 0. 


DSW codes that can be returned for each directive are listed in 
Chapter 4 with the individual directive descriptions. 


2.7 MEMORY MANAGEMENT 
VAX/VMS memory management facilities control the use of physical 
memory and virtual memory. VAX/VMS controls the use of physical 
memory by processes through implementation of two system concepts: 

e Balance sets and swapping 


e Working sets and paging 


The VAX/VMS Summary Description and Glossary details these concepts. 





2.7.1 Swapping 


The swapper determines which processes reside in main memory. All the 
resident processes are referred to as the balance set. Processes in 
the balance set compete for access to the central processor. 


VAX/VMS swaps processes from and to main memory to ensure that’ the 
highest priority processes are always available in memory for 
execution. The VAX/VMS swapper is more sophisticated than the RSX-11M 
checkpointing function. It does, however, provide an equivalent 
mechanism to allow emulation of the RSX-11M ENABLE CHECKPOINTING and 
DISABLE CHECKPOINTING directives. 
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The initial state of an RSX-11M image in a process is to have swapping 
(checkpointing) enabled. This state is identical to the initial state 
of an image under RSX-11M. To use the DISABLE CHECKPOINTING 
directive, an RSX-11M image must have the VAX/VMS privilege to set its 
swapping mode. 


Because VAX/VMS controls the use of physical memory by swapping 
processes out of and into a balance set, it does’ not support 
partitioning of physical memory. As a result, when an RSX-11M image 
issues a GET PARTITION PARAMETERS directive, VAX/VMS returns a 
Standard response for a system-controlled partition named GEN. See 
Chapter 4 for a description of the GET PARTITION PARAMETERS directive. 


VAX/VMS ignores the partition name in the image label block. 


2.7.2 Paging 


The virtual address space for a process consists of a number of 
512-byte pages. VAX/VMS, under control of the system manager, assigns 
each process a limited number of pages of physical memory that’ the 
process can use when it is in the balance set. That limit is referred 
to as the process's working set. Normally, a process is allowed a 
greater number of virtual pages than physical pages. The VAX/VMS 
pager determines the pages of a process's virtual address space that 
are in physical memory (that is, in the working set) at any time 
during process execution. 


VAX/VMS facilities for control of a process's virtual address space 
differ significantly from the RSX-11M approach to a task's virtual 
memory. As a result, VAX/VMS does not support the RSX-11M memory 
management (PLAS) directives. 


Every RSX-11M image has 65K bytes of virtual memory available to it. 
Because the address space is virtual rather than physical, RSX-11M 
images can avoid overlaying; an image executes more efficiently by 
depending on VAX/VMS memory management to determine which pages are 
needed in physical memory and when they are _ needed. Further 
efficiency can be gained by building RSX-11M images as shareable 
(JMU). So doing results in RSX-11M images that can be partially 
shared under VAX/VMS. 


2.8 SYSTEM EVENTS 


A system event in VAX/VMS is an occurrence that affects the ability of 
one or more processes in the system to execute. For example, an 
executing process can put itself in a wait state, or it can set an 
event flag that makes another process a candidate for execution. 
System events are similar in concept to RSX-11M significant events. 
In VAX/VMS, however, an image cannot request the declaration of a 
system event. No VAX/VMS equivalents for the DECLARE SIGNIFICANT 
EVENT and WAIT FOR SIGNIFICANT EVENT directives exist. Issuing either 
of these directives has no effect on VAX/VMS; Success status is 
returned to the issuing image. 


Therefore task images that run under VAX/VMS must use only event flags 
and mailboxes for intertask communication; they cannot meaningfully 
use significant events. 
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2.9 SYSTEM CLOCK 


On PDP-11 systems, the number of ticks per second varies depending on 
the type of clock used and its frequency. For the time-related 
directives, VAX/VMS emulates a 100-tick-per-Second clock. This 
difference may affect emulation of the following directives, which 
have time-oriented arguments. 


e MARK TIME 
r RUN 


e GET TIME PARAMETERS 


2.10 SOFTWARE PRIORITIES 


VAX/VMS priorities range from 0 through 15 for normal processes and 
from 16 through 31 for real-time processes. For further details on 
VAX/VMS handling of priorities, see the VAX/VMS_ Summary Description 


Because RSX-11M process’ priorities do not correspond to VAX/VMS 
priorities in a meaningful fashion, VAX/VMS does not attempt to 
convert a task's priority, as specified in the image's task header, to 
a VAX/VMS priority. 


An RSX-11M image runs at a priority that is determined by the default 
priority in the user authorization file entry for the user initiating 
the process. When an image issues an ALTER PRIORITY directive, 
VAX/VMS performs no operation, and image execution continues at the 
original process priority. An image requiring high priority must 
execute in a process that has sufficiently high priority to meet the 
image's needs. 


2.11 GLOBAL SECTIONS 


In VAX/VMS, global sections are disk files containing data or code 
that can be brought into memory and made available to processes for 
manipulation and execution. Global sections are created by executing 
images and by the system manager. 


When a global section is created, itsS creator assigns a set of 
characteristics to it. A global section can have the following 
characteristics: 


@e Read-only or read/write 

e Temporary or permanent 

e Group or system wide 
A temporary global section remains in the system only as long as 
processes are mapped to it; when no processes are mapped to it, 
VAX/VMS deletes it automatically. A permanent global section remains 
in the system until it is explicitly deleted. 
VAX/VMS provides group protection for group global sections. Any 


process can gain access to a system global section. A process must be 
privileged to create a permanent or system global section. 
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VAX/VMS imposes no limit on the number of global sections to which a 
process can map. 


When VAX/VMS loads an RSX-11M task image that was built specifying one 
of the options COMMON, LIBR, RESCOM, or RESLIB, it sets up the 
specified library or common for the image. When VAX/VMS loads- the 
RSX-11M image, it determines whether the global section for the 
library or common already exists. 


If the global section exists, it is one of the following: 
e A permanent global section created by the system manager 


e A temporary global section created by VAX/VMS as a result of 
previous RSX-11M image execution 


In either case, VAX/VMS maps the RSX-11M image to the global section. 


If the global section does not exist, VAX/VMS creates a temporary 
group global section for the library or common specified in the 
COMMON, LIBR, RESCOM, or RESLIB option to the task builder. The image 
file for either the library or common must be located on logical 
device and directory SYSSLIBRARY. 


When VAX/VMS creates a global section for use by RSX-11M images, the 
section has the following characteristics: 


e Global sections are accessed as either read-only or 
read/write, and either position dependent or _ position 
independent, according to the task builder specification. 


e Global sections are group and temporary. 


e The global section name is either the library name _ specified 
in a COMMON or LIBR option or the file name specified in a 
RESCOM or RESLIB option. 


The disk file for a read/write global section is updated to reflect 
data manipulation by processes that map to it. 


VAX/VMS does not incorporate the concept of an installed global 
section that can be reinstalled to obtain a fresh copy. The disk file 
for a read/write global section is updated to reflect data written in 
the global section. Therefore, if it is necessary to maintain the 
original state of a read/write (common) global section, the user must 
keep a protected copy of the common file ina place other than 
SYSSLIBRARY. 


If the library or common area referred to is not found, VAX/VMS prints 


an error message on SYSSERROR specifying the name of the library or 
common. 


2.12 HIBERNATION 


A hibernating process is in the system, but is inactive. Suspending 
or stopping a task image causes the task image to hibernate. 


A suspended task image can be reactivated by an asynchronous”) system 
trap (AST), or by a REQUEST TASK, RESUME TASK, or RUN TASK directive. 
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A stopped task image can be reactivated only by an UNSTOP' TASK 
directive located in an AST service routine or in another process, or 
by the setting of a specified event flag. 


In both DCL and MCR, the RUN command offers options which allow 
creation of a subprocess or detached process that is initially 
hibernating (rather than active). Before placing the process’ into 
hibernation, VAX/VMS loads the image, assigns any needed devices, and 
loads any needed libraries and common areas. 


2.13 IMAGE TERMINATION 


An image running in VAX/VMS can terminate normally or abnormally. 
Normal termination occurs when the image terminates of its own accord. 
Abnormal termination occurs when the system or another process’ forces 
the image to exit. 


2.13.1 Normal Termination 


When an RSX-11M image terminates normally, VAX/VMS performs the same 
image cleanup operations as it does for a native image. If an RSX-11M 
image issues a TASK EXIT directive, VAX/VMS executes an Exit system 
service and returns the termination status of SSS NORMAL. 


RSX-11M images also can issue an EXIT WITH STATUS directive to specify 
the appropriate status. For both VAX/VMS and RSX-11M images, the 
termination status is available to the command interpreter. 


Both the DCL and MCR command interpreters use the termination. status 
when processing indirect command files. DCL uses the termination 
Status with the ON command for error handling. MCR uses the status 
with .ONERR handling. The VAX-11/RSX-11M User's Guide describes the 
use of indirect command files with the MCR command interpreter. The 
VAX/VMS Guide to Using Command Procedures describes the use of DCL 


command procedures (indirect command files). 





2.13.2 Abnormal Termination 


When a VAX/VMS image incurs a potentially fatal error condition, 
either of the following can occur: 


e The image can handle the condition 
e VAX/VMS forces the image to terminate 


VAX/VMS images can react to fatal errors using the VAX/VMS- condition 
handling mechanism. Through that mechanism, an image can provide one 
or more condition handling routines that are to be executed to handle 
an exception (error) condition. The condition handling mechanism 
provides a function that is comparable to, but more flexible than, the 
RSX-11M synchronous’ system trap (SST) mechanism. VAX/VMS condition 
handling is described in the VAX/VMS System Services Reference Manual. 


If an image incurring an exception handles it, the image can continue 
execution or exit normally, as described above. If the image does not 
handle the exception, the system terminates the image by issuing an 
Exit system service. The Exit system service initiates image-related 
cleanup operations and saves the termination status. That status is 
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available to the command interpreter or the next image to execute in 
the process. 


Abnormal termination of an RSX-11M image can occur as a result of any 
of the following: 


e Violation of the hardware conventions for images. running in 
compatibility mode 


e Issuance of an instruction, other than EMT377, that causes a 
trap 


e Use of an illegal JMP or JSR instruction format 
e Occurrence of an odd address error 

e Violation of memory protection 

e Request for an abort from another process 

e Attempt to exceed virtual memory usage limits 


An RSX-11M image can supply a synchronous system trap (SST) service 
routine to handle some of the errors listed above. If the address of 
an SST service routine for an error is supplied in the SST vector 
table and that error occurs, VAX/VMS continues image execution in the 
SST routine. The routine determines whether the image is to exit or 
continue. If no SST address is supplied, VAX/VMS terminates the 
image. 


If the error is one that’ cannot be handled by an SST service routine 
or if no valid SST routine address is supplied, VAX/VMS issues a 
termination message on the device assigned to SYSSERROR and 
SYSSOUTPUT. VAX/VMS causes the image to exit with a termination 
status that is available to the command interpreter. 


Table 2-1 lists the reasons for image termination and indicates which 
errors can be handled by an SST service routine. The status codes in 
parentheses following the termination messages are defined by SRSXDEF 
macro. 


Table 2-1 
Reasons for RSX-11M Image Termination 


Status Code 


RSX$_I0T 







Message and Explanation 
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IOT EXECUTION 


The image executed an IOT instruction. 






RSXS_ BREAK BPT EXECUTION 


The image executed a BPT instruction. 






RSXS$_TBIT T-BIT EXECUTION 






The image executed an instruction 
T-bit trap. 


requiring a 
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(continued on next page) 
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Table 2-1 (Cont.) 
Reasons for RSX-11M Image Termination 


Status Code Message and Explanation 






RSXS$_TRAP TRAP EXECUTION 
The image executed a trap instruction. 
RSX$_NONRSXEMT NON-RSX EMT EXECUTION 
The image executed an invalid EMT instruction. 
RSXS_ILLINST ILLEGAL INSTRUCTION 


The image executed a JMP or JSR instruction with 
a register as the destination. 


RSX$_ACCVIO MEMORY PROTECTION VIOLATION 


The image addressed a location outside its 
virtual address space.l 


RSX$_ODDADDR ODD ADDRESS ERROR 


The image addressed a word at an odd address 
(nonword boundary) .1 


RSX$_ RESERVED RESERVED INSTRUCTION 
The image executed an instruction that is not 
allowed in compatibility mode (HALT, MARK, 
RESET, SPL, or WAIT) .1L 

RSXS$_BADSTACK BAD STACK 


The stack pointer contains an address outside 
the image's virtual address space. 


RSX$_INSFDYNMEM NO DYNAMIC SPACE 


A requested service needs more dynamic’ space 
than the process is allowed. 





1. The returned PC is the address of the had instruction, not the 
address following it. 


2. This error cannot be trapped to the SST vector table. 


2.14 PARSING OF FILE SPECIFICATIONS 


Because of the VAX/VMS logical name capability, VAX/VMS file 
specifications can differ from those used in RSX-11M. The normal 
RSX-11M parsing routines cannot provide defaults for such VAX/VMS file 
specifications. VAX/VMS provides a special directive that is issued 
by FCS and RMS-11 running under VAX/VMS so that they provide proper 
defaults in a manner that is transparent to the RSX-11M image. Any 
RSX-11M image that performs its own parsing also must call this 
special directive, which is described in Appendix B. 
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An RSX-11M image issuing such a directive uses the same sources’ for 
default information as it does under RSX-11M (for example, the default 
file name block and directory string). When the directive is issued, 
VAX/VMS builds the necessary data structures and calls VAX-11 RMS. 
When VAX-11 RMS returns the expanded file specification, VAX/VMS 
returns it to the image in the format used by FCS and RMS-11 (for 
example, in the resultant file name block and directory string). 


2.15 VAX/VMS I/O SYSTEM 
VAX/VMS uses its own I/O system in duplicating RSX-11M I/O operations. 
Components at all levels of the VAX/VMS I/O system provide functions 
that are similar to equivalent functions in RSX-11M. For example, 
VAX/VMS I/O system services provide functions similar to those 
provided by RSX-11M I/O directives. Differences between the two 1/0 
systems arise in the following cases: 
e VAX/VMS implementation of a function varies from RSX-11M 
implementation to provide more flexibility or efficiency (for 
example, certain Queue I/O Request function codes) 


@e VAX/VMS implementation of a function or concept not provided 
in RSX-11M and use of that function in emulating RSX-11M I/0 


Such differences affect emulation of the following T/O-related 
directives. 


@ ASSIGN LUN 

e GET LUN INFORMATION 

@e QUEUE I/O REQUEST 

@e QUEUE I/O REQUEST AND WAIT 
e SEND DATA 

@e RECEIVE DATA 

@e RECEIVE DATA OR EXIT 

@ RECEIVE DATA OR STOP 


Chapter 3 presents an overview of the VAX/VMS I/O system and relates 
aspects of it to an RSX-11M image. 


CHAPTER 3 


VAX/VMS 1/0 SYSTEM 


The I/O VAX/VMS system comprises the following components: 


e VAX-11 Record Management Services (VAX~11 RMS) for user-level, 
device-independent I/0 


e I/0 system services that provide the means for an image to 
assign devices and issue I/O requests directly 


e Ancillary control processes (ACPs) for performing 
file-oriented functions on disk and magnetic tape volumes 


e I/0 drivers 


Figure 3-1 illustrates the relationships among these components. 


3.1 VAX-11 RMS 


VAX/VMS Record Management Services (VAX-1l1l RMS) provide native VAX/VMS 
images with the capability to perform device-independent I/O. Images 
issue commands to open a file, get and put records or read and write 
blocks, and close the _ file. VAX-11 RMS, in turn, issues the I/0 
system services that cause the driver or ancillary control process 
(ACP) to perform the function requested by the user. 


VAX-11 RMS is the VAX/VMS equivalent of FCS and RMS-1l. It has no 
Girect effect on and is inaccessible to an RSX-11M image executing in 
compatibility mode. VAX/VMS does, however, call VAX-11 RMS to perform 
some I/O services on behalf of an RSX-11M image. 


VAX-11 RMS is described in the VAX-11 Record Management Services 
Reference Manual. 
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VAX/VMS 
image 


1/0 system services 


1/O drivers 


Peripheral 
devices 


Figure 3-1 Components of VAX/VMS I/O System 


3.2 VAX/VMS I/O SYSTEM SERVICES 
A native image can call VAX/VMS I/O system services to describe its 
I/O requirements directly, that is, without using VAX-11 RMS. The 
request can be issued by a usSer image or by VAX-11 RMS on behalf of a 
user image. I/O services allow suitably privileged processes to 
request the following functions: 

e Assign and deassign channels 

@e Queue an I/O request and (optionally) wait for its completion 

e Create and delete mailboxes 

e Allocate and deallocate devices 


e Get device information 


e Cancel I/O on a channel 
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3.2.1 Assign I/O Channel System Service 


Before a VAX/VMS image can request an I/O operation, it must establish 
a path of reference from the process in which it is executing to the 
device on which the operation is to be performed. In VAX/VMS, this 
path of reference is obtained by calling the Assign I/O Channel system 
service. This service returns a channel number (path designator) for 
the assigned device. The channel number remains valid until the image 
deassigns the channel or terminates. 


In addition to the channels assigned by an image, a process’ has 
channels assigned by the system. These channels are permanent for the 
duration of the process. They provide the path of reference for the 
process-permanent files used for system input (SYSSINPUT and 
SYSSCOMMAND), system output (SYSSOUTPUT), error messages (SYSSERROR), 
and any user-created process-permanent files. For RSX-11M images 
under VAX/VMS, uSer-created process-permanent files appear as 
record-oriented terminal devices. 


An image can request I/O operations on channels that it assigns and on 
those that the system assigns to process-permanent files. However, 
VAX-11 RMS must be used for I/O operations to process-permanent' files 
except those mapping to terminal devices. The Assign I/O Channel 
system service is the VAX/VMS equivalent of the ASSIGN LUN directive. 


3.2.2 Queue I/O Request System Service 


Once the image has assigned a channel to a device, the image can 
request I/O operations by calling the Queue I/O Request system service 
and specifying the channel number returned by the Assign I/0 Channel 
system service as an argument. Additional arguments’ provide 
function-dependent and function-independent data required for the I/0 
operation. 


When called, the Queue I/O Request system service allocates and builds 
an I/0 request packet that describes the operation to be performed as 
indicated by the arguments passed to it by the image. Once the packet 
is built, the Queue I/O Request system service places the packet ina 
queue of requests for the designated device. Requests are queued 
according to the priority of the process from which the image issued 
the request. The driver for the device unit dequeues requests by 
priority and performs them. 


3.2.3 Create Mailbox and Assign I/O Channel System Service 


The Create Mailbox and Assign I/O Channel system service lets an image 
create a virtual device, called a mailbox, and assign an I/O channel 
to it. Mailboxes provide the mechanism for protected interprocess 
communication in VAX/VMS. Normally, an image creates a mailbox from 
which it reads and to which other images in cooperating processes 
write. Access to the mailbox is restricted using the normal UIC-based 
protection according to system, owner, group, and _ world. An image 
performs I/0 operations on a mailbox using VAX-11 RMS SGET and SPUT 
commands or the Queue I/O Request system service. 


A mailbox has no RSX-11M equivalent. However, VAX/VMS does” use 
mailboxes in duplicating RSX-11M send/receive directives. If a 
logical name is assigned to an existing mailbox, an RSX-11M image can 
issue I/O requests to the mailbox using the mailbox's logical name. 
An RSX-11M image cannot create a mailbox directly. Use of mailboxes 
for send/receive directives is detailed in Section 3.8.1. 
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3.2.4 Additional I/O System Services 


The Allocate Device system service lets an image reserve a device for 
exclusive use by the process in which the image is executing. The 
device remains allocated until it is explicitly deallocated or until 
the process terminates. VAX/VMS automatically allocates any 
nonshareable device (for example, terminal or card reader) assigned by 
a process. It does not automatically allocate a shareable device (for 
example, disk). The concept of device allocation is the VAX/VMS 
equivalent of the RSX-11M concept of attaching a device. 


The Get Device Information system service lets an image obtain the 
name and characteristics of the device assigned to a particular 
channel. It is equivalent to the GET LUN INFORMATION directive in 


The Cancel I/O Request system service lets an image cancel all I/0 
requests pending on the specified channel. It is equivalent to the 
RSX-11M QUEUE I/O REQUEST directive with a function code of IO.KIL. 


I/O system services are described in the VAX/VMS System _ Services 
Reference Manual. 


3.3 I/O DRIVERS AND ACPs 


Using information in the I/O request packet, the I/O driver for the 
unit to which the request was queued initiates the actual hardware 
operation that performs the requested function. Once the transfer is 
initiated, the driver returns control to the Queue I/O Request system 
service. The service returns the request status to its caller. When 
the hardware operation completes, the hardware generates an interrupt 
that causes the driver to be reentered to complete processing of the 
I/O request. 


When the driver completes the I/O request, it issues a_e software 
interrupt for the I/O post routine. The I/O post routine sets up the 
mechanism that causes user-requested I/O completion information to be 
passed to the image. For example, it fills in the I/O status block 
and passes information needed to set an event flag or queue an AST, if 
either is requested. 


If the driver cannot perform the request because it requires handling 
of file-structured volumes, ACP intervention is needed. In that case, 
the driver queues the request for the appropriate ACP to perform. 


3.4 RSX-11M IMAGE INTERFACE TO THE VAX/VMS I/O SYSTEM 


RSX-11M images perform I/O by issuing requests to FCS/RMS-11 level or 
by uSing the QIO$ directive level. The number of steps required to 
perform each I/O operation varies depending on the level of the 
request. Figure 3-2 illustrates the interface between an RSX-11M 
image and the VAX/VMS I/O system. 
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VAX/VMS returns DSW code 
to image issuing Q!O$ 


Driver notifies VAX/VMS 


of 1/0 completion 
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if 1OSB is defined 


VAX/VMS issues I/O done 
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VAX-11 RMS $GET or $PUT 








VAX-11 RMS issues 
appropriate $O10 


Figure 3-2 RSX-11M Image Interface to VAX/VMS I/O System 
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Images issuing FCS and RMS-1l requests use the same FCS and RMS-1l1 
routines available in RSX-11M.1 Some of these routines have been 
modified to take advantage of VAX/VMS features, such as_ directory 
naming and file specification parsing. To take advantage of the 
modifications, the RSX-11M image must be rebuilt under VAX/VMS. The 
VAX/VMS modifications are compatible with RSX-11M versions of FCS and 
RMS-11. 


Both FCS and RMS-11 run in compatibility mode under VAX/VMS. When an 
RSX-11M image issues either an FCS or RMS-11 request, FCS or RMS-11 
receives the request and reacts to it in the same mannner as it does 
when running in RSX-11M. That is, FCS/RMS-11 issues the appropriate 
RSX~11M QIOS directive. 


From this point, the steps are identical to those taken when any 
RSX-11M image issues a QIOS directive: 


e The QIOS directive traps to VAX/VMS. 


e VAX/VMS determines whether the QIOS was to a process-permanent 
file, such as TI or SYSSOUTPUT. If it is and that device is 
not a terminal, VAX/VMS issues a VAX-11 RMS SGET or S$PUT 
request. Otherwise, VAX/VMS issues the VAX/VMS SQIO system 
service request that corresponds to the RSX-11M QIOS. 


e Upon completion of the QIO request, VAX/VMS' returns” the 
appropriate DSW code to the issuing image. 


e Upon completion of the I/O operation, VAX/VMS returns” status 
information in the I/O status block and sets an event flag or 
declares an AST, if requested. 


If the routine to which the DSW code is returned is either FCS or 
RMS-11, that component in turn makes the appropriate status return to 
the calling image. 


3.5 DEVICE ASSIGNMENT 


VAX/VMS performs device assignment for RSX-11M images as part of image 
initialization when the image is loaded. It also performs device 
assignment during image execution as a result of an ASSIGN _ LUN 
directive. 


In making a device assignment for an RSX-11M image, VAX/VMS- proceeds 
with the following steps, which result in the device unit's physical 
name. 


e VAX/VMS forms an ASCII string using the device name and unit 
number supplied by the image. VAX/VMS uses the two characters 
plus the binary unit number’ supplied. The unit number is 
converted to ASCII base 8. No editing is performed on the 
name; for example, if TTl is supplied, that name is’ used 
rather than TTOl. 


1. Because the VAX/VMS Files-11 ACP does not support block locking, 
RMS-11 block locking across processes iS not supported. As a result, 
RMS-11 does not allow file sharing for write-accessed files of 
relative and indexed organization under VAX/VMS. 
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e VAX/VMS attempts to translate the ASCII string as a_ logical 
name uSing the Translate Logical Name system service. If the 
attempt to translate fails, VAX/VMS assumes that the image 
supplied an RSX-11M physical device name. It converts the 
unit number to decimal. It builds a VAX/VMS physical device 
name uSing the image's original input and issues an Assign I/0 
Channel system service using the VAX/VMS device name. VAX/VMS 
maps RSX-11M physical device names to VAX/VMS physical device 
names, as described in Section 3.6. 


If the name translates, VAX/VMS attempts up to two more 
translations. If the maximum number of translations (three) 
is performed or if one of the attempts results in no 
translation, VAX/VMS assigns a channel using the _ final 
equivalence name. 


For example, if INO is defined as a process's logical name for TTB3 
and that process- runs an RSX-11M image which subsequently issues an 
ASSIGN LUN directive for INO, VAX/VMS forms an ASCII string for INO, 
translates the string to TTB3, and assigns a channel to TTB3. 


3.6 DEVICE MAPPING 


If the user does not assign the RSX-11M device name as_ the _ logical 
name for a VAX/VMS physical device unit, VAX/VMS' automatically 
performs the translation to a physical device. (A mailbox is an 
exception; its device name is MBAn, where n is its unit number.) This 
conversion is done by converting the RSX-11M unit number to decimal 
and dividing it by 16 (decimal). The quotient is added to the ASCII 
value representing the character A. The result is the controller 
letter. The remainder becomes the VAX/VMS unit number. For example, 
RSX-11M devices TTO and DB18 become VAX/VMS devices TTAO and ODBB2, 
respectively. 


TTO to TTAO: 
Controller and unit='A'+(0/16)='A'+0 with a remainder of 0 


'A'+0='A'=controller 
Q=unit number 


DB18 to DBB2: 
Controller and unit='A'+(18/16)="A'+1 with a remainder of 2 


"A'4+1='"B'=controller 
2=unit number 


VAX/VMS performs this conversion when assigning an I/O device for an 
RSX-11M image. 
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To convert back from a VAX/VMS device name to the RSX-11M forn, 
VAX/VMS performs the reverse operation. It subtracts the value 
representing the ASCII character A (65) from the controller letter and 
multiplies the result by 16 (decimal). It then adds the VAX/VMS unit 
number. The result is an RSX-11M unit number that is appended to the 
2-character device name. For example, the VAX/VMS device name LPBl 
converts to the RSX-11M device name LP17. 


LPBl to LP17: 

Unit =(('B' - 'A') * 16) + 1 = (1 * 16) + 1 =417 
VAX/VMS performs this conversion and stores it in the RSX-l11M logical 
name list for the image. This device information is returned as a 
result of a GET LUN INFORMATION directive. 
The logical names TI, CL, CO, SY, and OV are exceptions to the rules 


for device name mapping. Table 3-1 shows device name mapping for 
VAX/VMS logical names. 


Table 3-1 
Device Name Mapping 






RSX-11M 


Name VAX/VMS Name 
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SYSSINPUT 
SYSSOUTPUT 


SYSSERROR 

SYSSCOMMAND 

SYSSDISK 

Name assigned by system manager 
Name assigned by system manager 
Name assigned by system manager 


For the LUN used by the overlay 
run-time system, OVO translates’ to 
provide access to the task image file. 
Any other LUNS assigned to OVO cause 
VAX/VMS to assign the device on _ which 
the image resides. 


3.7 HANDLING OF QUEUE I/O FUNCTION CODES 


VAX/VMS-_ provides both device-independent and device-dependent 
functions at the Queue I/O Request service level. Device-independent 
functions include read and write virtual block, read and write logical 
block, and read and write physical block. Device-dependent functions 
include operations such as the handling of control and escape 
sequences for terminal I/0 and_ positioning functions for magnetic 
tape. For most RSX-11M function codes, VAX/VMS has ae corresponding 
function code or system _ service. All disk and most magnetic tape 
function codes have corresponding functions in VAX/VMS. However, two 
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areas exist where discrepancies between RSX-11M and VAX/VMS device 
handling may appear: 


e Handling of terminal devices 
e Handling of spooled devices 


Details concerning VAX/VMS handling of all RSX-11M device’ function 
codes are provided in Chapter 5. The implications of spooling for 
RSX-11M images is described in Section 3.10. 


3.8 MAILBOXES 


A mailbox is a record-oriented virtual device used in VAX/VMS_~ for 
generalized communication among processes. VAX/VMS uses a mailbox to 
duplicate the RSX-11M RECEIVE DATA, RECEIVE DATA OR EXIT, RECEIVE DATA 
OR STOP, and SEND DATA directives. These directives are the normal 
means of intertask communication in the RSX-11M environment. 


A mailbox has UIC-based protection associated with it. The creator of 
the mailbox can specify read and write privileges for system, owner, 
group, and world. Because the concepts of execute and delete are not 
meaningful for mailboxes, the creator does not specify privileges for 
these functions. 


When VAX/VMS creates a mailbox for emulating the send/receive 
directives, it specifies read access for the owner and write access 
for the group. The owner is the image issuing the receive directives 
and the group comprises the images issuing the send directives. Owner 
and group are identified by the UIC under which they execute. 


3.8.1 Mailboxes for Send/Receive Directives 


When VAX/VMS loads a compatibility mode image, it determines whether 
the image has a task name by examining the image's task label -block. 
The presence of a task name in the label block is an indication that 
the image can issue RECEIVE DATA, RECEIVE DATA OR EXIT, and RECEIVE 
DATA OR STOP directives to obtain data sent to it by other images. 
The system defines a process name that is identical to the task name 
in the label block. If the name is unique, just prior to actual image 
execution, the system creates a mailbox and associates it with the 
process. The mailbox is named as follows: 


RCVDtaskname 


The name is qualified by group number. Other images that send data to 
the mailbox must be within the same group and have group or world 
privilege. 


VAX/VMS does not create a mailbox for an image having a task name in 
the form ...xxx, for example, ...MAC. 


Figure 3-3 illustrates the use of mailboxes for the send and_ receive 
functions, 
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Figure 3-3 Use of Mailboxes for Send/Receive Directives 


3.8.2 I/0 to Mailboxes 


A mailbox has a device name of MBAn. The value of n is the unit 
number. VAX/VMS unit numbers are 5-digit numbers in the range 0 to 
65535. When an image creates a mailbox, VAX/VMS assigns a unit number 
£O - 1b. Each time an image executes, the unit number assigned by 
VAX/VMS to any mailboxes that the image creates can vary. 


Because mailboxes are treated as devices under VAX/VMS, any RSX-11M 
image can assign a channel to a mailbox using its logical name and 
perform record I/O to it. The RSX-11M image must use the logical name 
rather than the device name (MBAn) to refer to the mailbox because 
RSX-11M images can accept only a unit number in the range 0 to 255. 


Either an RSX-11M image or a native VAX/VMS image can assign a 
mailbox; only a native VAX/VMS image can create a mailbox. A mailbox 
assigned by an RSX-11M image must be either permanently available in 
the system or created by a native image. Assignment of a mailbox is 
treated the same as the assignment of other VAX/VMS devices’ for 
RSX-11M images. 


A mailbox can be shared by native images and RSX-11M images. AS a 
result, mailboxes provide a convenient means for native images to 
communicate with RSX-11M images. The mailbox used for such 
communication can be created by a native image or created by VAX/VMS 
for emulating the send and receive directives. 


A native image can send messages to a mailbox created for directive 
emulation by issuing write requests to it. The image can use either 
VAX-11 RMS or the Queue I/O Request system service for the I/0 
operations. 
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3.9 ACP FUNCTIONS 


RSX-11M Files-11 ACP functions correspond directly to VAX/VMS Files-1ll 
ACP functions. The mapping is transparent to the RSX-11M image, as 
described in Chapter 5. 


3.10 SPOOLED DEVICES 


Under VAX/VMS, spooling occurs as a result of cooperation among the 
I/O related system services: Files-l1l1 ACP, VAX-11 RMS, and output 
symbionts. Spooling in RSX-11M requires interaction with the RSX-11M 
spooler. Use of VAX/VMS' spooled devices is transparent to RSX-11M 
images. 


If an image assigns a device that is spooled (for example, a _ line 
printer) the resulting assignment is actually to an intermediate 
device (for example, a disk). If the image issues a GET LUN 
INFORMATION directive, the system returns characteristics that are 
consistent with the intermediate device containing the spooled files. 
Characteristics of the final output device (the line printer) are not 
returned to the RSX-11M image, 


If an image uses RMS-11 or FCS to access a spooled device, the file is 
spooled when it is deaccessed. 


Use of the QUEUE I/O REQUEST directive to a VAX/VMS spooled device 
without preceding the request with an OPENS macro or appropriate ACP 
functions results in a privilege violation status return. Because the 
device to which the QUEUE I/O REQUEST directive actually is directed 
is a file-structured device, the appropriate ACP functions (for 
example, access file) muSt occur before I/0 to the device can he 
performed. Use of RMS-11 or FCS PUTS requests ensures that the ACP 
functions occur. 


3.10.1 FCS Spooling 


The FCS spooling macro PRINTS and the services associated with it 
under RSX-11M are supported in VAX/VMS, Spooling in RSX-11M is 
accomplished by a task named PRT... . When VAX/VMS detects a SEND 
DATA directive with PRT... as the target, it executes a Send Message 
to Symbiont Manager system service to spool the file. 


CHAPTER 4 


DIRECTIVE DESCRIPTIONS 


This chapter describes how VAX/VMS handles RSX-11M directives. 
VAX/VMS handling that is different from RSX-11M handling is 
gray~sShaded. 


Section 4.1 summarizes differences between VAX/VMS” and RSX-11M 
handling of directives. All directives supported under VAX/VMS are 


described in Section 4.2. These directives are alphabetized by macro 
name. 


4.1 VAX/VMS HANDLING OF DIRECTIVES 


Table 4-1 outlines the differences between RSX-11M and VAX/VMS 
handling of directives. For each directive, the table gives the macro 
name and the principal differences in handling. The numbers’ in 
parentheses refer to sections (other than the directive description in 
this chapter) that further clarify the VAX/VMS handling. 


Table 4-1 
VAX/VMS Handling of Directives 












Directive Name, Differences, and Section References 


Macro 


ABRTS 


ALTPS 


ALUNS 
ASTXSS 







ABORT TASK 








Process protected by group (2.2); group or world 
privilege required (2.1); process name required for 
target image (2.4). 
ALTER PRIORITY 


No operation (2.10). 






ASSIGN LUN 








Logical name translated (3.5); device assignment required 
(3.5); devices mapped (3.6). 


AST SERVICE EXIT 


No differences. 
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Macro 


ATRGS$ 
CINTS 
CLEFS 


CMKTS 


CNCTS 
CRAWS 
CRFGS 
CRRG$ 


CSRQS 


DECLSS 
DSARSS 


DSCPSS 
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Table 4-1 (Cont.) 
VAX/VMS Handling of Directives 


Directive Name, Differences, and Section References 





ATTACH REGION 
Not supported. 
CONNECT TO INTERRUPT VECTOR 
Not supported. 


CLEAR EVENT FLAG 


No differences. 





CANCEL MARK TIME REQUESTS 





Process protected by group (2.2); group or world 
privilege required (2.1). 





CONNECT 
Not supported. 


CREATE ADDRESS WINDOW 


Not supported. 





CREATE GROUP GLOBAL EVENT FLAGS 


Group global event flags protected by group (2.5). 


nen nee tthe 


CREATE REGION 


Not supported. 


pcan nl ethernet 


Process protected by group (2.2); group or world 
privilege required (2.1); process name required for 
target image (2.4). 
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DECLARE SIGNIFICANT EVENT 








No operation performed (2.8). 
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DISABLE AST RECOGNITION 





ponent nena etek erate etn nite ae 


No differences. 
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DISABLE CHECKPOINTING 


Set swap mode privilege required (2.1, 2.7.1). 
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Macro 


DTRGS 


ELAWS 


ELGFS 


ENARSS 


ENCPSS 


EXIFS 


EXITSS 


EXSTS 


EXTKS 


GLUNS 


GMCRS$ 


GMCXS 


GPRTS 
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Table 4-1 (Cont.) 
VAX/VMS Handling of Directives 


Directive Name, Differences, and Section References 


DETACH REGION 
Not supported. 
ELIMINATE ADDRESS WINDOW 
Not supported. 


ELIMINATE GROUP GLOBAL EVENT FLAGS 


Group global event flags protected by group (2.5). 


ENABLE AST RECOGNITION 
No differences. 


ENABLE CHECKPOINTING 


Set swap mode privilege required (2.1, 2.7.1). 


EXIT IF 

Image termination (2.13). 
TASK EXIT 

Image termination (2.13). 
EXIT WITH STATUS 

Image termination (2.13). 
EXTEND TASK 

No differences. 

GET LUN INFORMATION 


Intermediate device information given for 
(34:10,,> 542) 


GET MCR COMMAND LINE 
No differences. 
GET MAPPING CONTEXT 
Not supported. 


GET PARTITION PARAMETERS 


Parameters given for GEN partition (2.7.1). 


spooled device 
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Macro 


GREGS 
GSSWSS 
GTIMS 
GTSKS$ 
MAPS 
MRKTS 


QIos 


QIows 


RCSTS 


RCVDS 


RCVXS 


RDAFS 
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Table 4-1 (Cont.) 
VAX/VMS Handling of Directives 


Directive Name, Differences, and Section References 


GET REGION PARAMETERS 

Not supported. 

GET SENSE SWITCHES 

Not supported. 

GET TIME PARAMETERS 

100 tick-per-second clock used (2.9). 


GET TASK PARAMETERS 


Parameters given for GEN partition (2.7.1). 


MAP ADDRESS WINDOW 
Not supported. 


MARK TIME 





sere Amante net taney nego ae nt 


QUEUE I/O REQUEST 


Function codes mapped to VAX/VMS function 
5) 6 


QUEUE I/O REQUEST AND WAIT 


Function codes mapped to VAX/VMS function 
5). 


RECEIVE DATA OR STOP 


Mailbox used (3.8.1); protected by 


privilege required (2.1); process name 


target image (2.4). 





RECEIVE DATA 


Mailbox used (3.8.1); protected by 


privilege required (2.1); process name 


target image (2.4). 
RECEIVE DATA OR EXIT 


Mailbox used (3.8.1); protected by 


privilege required (2.1); process name 


target image (2.4). 
READ ALL EVENT FLAGS 


No differences. 


codes (Chapter 


codes (Chapter 


group (2.2); 
required for 


group (2.2); 
required for 


group (2.2); 
required for 
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RDXFS$ 


ROSTS 


RREFS 


RSUMS 


RUNS 


SDATS 


SETFS 


SFPAS 


SPNDSS 


SPRAS 


SPWNS 
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Table 4-1 (Cont.) 
VAX/VMS Handling of Directives 


Directive Name, Differences, and Section References 


READ EXTENDED EVENT FLAGS 

No differences. 

REQUEST TASK 

Active or hibernating target image required (2.12); 


protected by group (2.2); privilege required (2.1); 
process name required for target image (2.4). 





RECEIVE BY REFERENCE 
Not supported. 
RESUME TASK 


Protected by group (2.2); privilege required (2.1); 
process name required for target image (2.4). 


RUN TASK 


Active or hibernating target image required (212) 3 
protected by group (2.2); privilege required (2.1); 
process name required for target image (2.4). 


ae ree en A A Ne 


SEND DATA 
Mailbox used (3.8.1); protected by group (2.2); 
privilege required (2.1); process name required for 


target image (2.4). 

SET EVENT FLAG 

No differences. 

SPECIFY FLOATING-POINT PROCESSOR EXCEPTION AST 
No differences. 

SUSPEND 

Process name required for caller (2.4). 
SPECIFY POWER RECOVERY AST 

No differences. 

SPAWN 

For command line handling, mailbox used (3.8.1); 


protected by group (2.2); privilege required (2.1). 


eet 
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Table 4-1 (Cont.) 
VAX/VMS Handling of Directives 





Macro Directive Name, Differences, and Section References 


poe ven: hes atten on uumtenatanasnmsangsgetagainatnateshsiennivceeseney ie 


SRDAS SPECIFY RECEIVE DATA AST 


No differences, 





SREFS$ SEND BY REFERENCE 


Not supported. 


tmttnenncprmresnntnrennetnenst rset nettensmtntentng tebe erent ttitittentener reprint er Snterenmn eet stn 


SRRAS SPECIFY RECEIVE-BY-REFERENCE AST 


Not supported. 


STLOS STOP FOR LOGICAL OR OF EVENT FLAGS 


No differences. 





STOPSS | STOP 


No differences. 


STSES STOP FOR SINGLE EVENT FLAG 


No differences. 


PT spittin taste Ne tt nak seen hy ota nba eter tanto tenet. |” seeetemtenener Sener SRSA ARONA eee sawn ate 


SVDBS$ SPECIFY SST VECTOR TABLE FOR DEBUGGING AID 


No differences. 


SVTKS SPECIFY SST VECTOR TABLE FOR TASK 


No differences. 


UMAPS UNMAP ADDRESS WINDOW 


Not supported. 


USTPS UNSTOP TASK 





carers ah ener tenner ne ne nner ep eeretueeuneenttnereytpitnn ersten 


Active or hibernating target image required (2.12): 
protected by group (2.2); privilege required (2.1); 
process name required for target image (2.4). 





WSIGSS | WAIT FOR SIGNIFICANT EVENT 

No operation performed (2.8). 

WTLOS WAIT FOR LOGICAL OR OF EVENT FLAGS” 
No differences. 


WTSES WAIT FOR SINGLE EVENT FLAG 





No differences. 
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4.2 SYSTEM DIRECTIVE DESCRIPTIONS 


Each directive description includes all or most of the following 
elements, aS appropriate: 


Name: 
The function of the directive in VAX/VMS is described. 


Macro Call: 


The macro call is shown, each parameter is defined, and_ the 
defaults for optional parameters are given in parentheses 
following the definition of the parameter. Since zero is 
supplied for most defaulted parameters, only nonzero default 
values are shown. Parameters ignored by VAX/VMS and RSX-11M_ are 
required for compatibility with RSX-11D and IAS. 


DSW Return Code: 


All return codes that are valid under VAX/VMS are listed and 
defined. In some cases, a VAX/VMS return status code in 
parentheses follows an RSX-11M status code. For example: 


IE.RSU -- Device allocated to another image (SS$_DEVALLOC) 


The VAX/VMS code indicates the VAX/VMS error that caused the 
corresponding RSX-11M code to be returned. 


Some RSX-11M codes reflect several VAX/VMS codes. In this caSe, 
VAX/VMS returns’ the RSX-11M code that it uses by default. Such 
codes are followed by the phrase "default error" in parentheses. 
For example: 


IE.IDU -- Device or unit unknown (default error) 


In some cases after a directive failure, VAX/VMS returns an error 
code that is more meaningful for an I/O operation. In these 
cases, the high-order byte of the DSW contains 0. 


Notes: 


The notes presented with some directive descriptions further 
explain the function, use, and/or consequences of these 
directives under VAX/VMS. Users should read the notes carefully 
to ensure proper use of directives. 
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ABRTS 


4.2.1 ABRTS - ABORT TASK 

The ABORT TASK directive instructs the system to terminate the 
execution of the indicated process's image. The requester can abort 
itself or an image executing in another. process. ABORT TASK is 
intended for uSe aS an emergency or fault exit. 

Macro Call: 


ABRTS tsk 





DSW Return Codes: 


IS.SUC -- Successful completion 
IE.INS -- Process name unknown (default error) 
IE.PRI User not privileged (SS$ NOPRIV) 





pacts ie _ ndauders 
address space 
IE.SDP -- DIC or DPB size is invalid 


Notes: 
@ VAX/VMS executes a Force Exit system service to terminate’ the 
specified process's image on behalf of the image issuing the 
ABORT TASK directive. 


e The image issuing the ABORT TASK directive must be executing 
in a process that meets either of the following requirements: 


-- It is in the same group as the process to be aborted and 
has group privilege. 


-- It has world privilege. 
e The exit status is supplied by an exit handling routine (exit 


handler). It is assumed that the status returns a severe 
error. 
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ALTP$ 


4.2.2 ALTP$ - ALTER PRIORITY 





Se 


Macro Call: 
ALTPS [tsk] [,pri] 


tsk = Active task name 
pri = New priority, a number from 1 to 250 (decimal) 


DSW Return Codes: 


IS.SUC -- Successful completion 

IE.ADP -- Part of the DPB is out of the issuing image's address 
space 

IE.SDP -- DIC or DPB size is invalid 
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ALUNS 


4.2.3 ALUNS - ASSIGN LUN 


The ASSIGN LUN directive instructs the system to assign a_ physical 


device 


unit to a logical unit number. An I/O channel is the VAX/VMS 


equivalent of an RSX-11M logical unit number. 





Macro Call: 


ALUNS lun,dev,unt 


lun = Logical unit number 
dev = Device name (two characters) 
unt = Device unit number 


DSW Return Codes: 


Is. 
IE. 
IE. 








SUC -- Successful completion 
IDU Device or unit unknown (default error) 
ILU Invalid logical unit number 





IE. 


Notes: 


address space 
SDP -- DIC or DPB size is invalid 


VAX/VMS executes an AsSign I/O Channel system service on 
behalf of the image issuing the ASSIGN LUN directive. 


The assignment of RSX-11M device names to VAX/VMS_- physical 
devices is described in Section:3.5. 


If the RSX-11M device name and logical unit number are not 
assigned as the logical name of a VAX/VMS device, VAX/VMS maps 
the RSX-11M device name and unit number to an appropriate 
VAX/VMS device name, controller, and unit number. To perform 
the mapping, VAX/VMS divides the RSX-11M unit number by 16 
(decimal). The quotient is added to the ASCII value 
representing the character A. The result is the controller 
designation. The remainder becomes the VAX/VMS unit number. 
The following is an example of the conversion. 


RSX-11M device name and unit number = DB2 
"A'+(2/16) = 'A'+0 with a remainder of 2 


The corresponding VAX/VMS device name, controller letter, and 
unit number = DBA2. 


If a LUN is reassigned, its previous assignment is deassigned. 
The deassignment causes I/0 to be canceled on the old 
assignment. If the attempt to make a new assignment fails, 
the LUN remains deasSigned. 
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ASTX$S 


4.2.4 ASTX$S - AST SERVICE EXIT 


The AST SERVICE EXIT directive instructs the system to terminate 
execution of an AST service routine. 


If another AST is queued and ASTS are not disabled, VAX/VMS 
immediately effects the next AST. Otherwise, the system restores the 
image's state prior to the AST. 
Macro Call: 

ASTXSS [err] 


err = Error routine address 


DSW Return Codes: 


Is.SUC -- Successful completion 
IE.AST -- Directive not issued from an AST service routine 
IE.ADP -- Part of the DPB or stack is out of the issuing 
image's address space 
IE.SDP -- DIC or DPB size is invalid 
Note: 


e When an AST occurs, VAX/VMS pushes, at minimum, the following 
information onto the stack: 


SP+06,012 -- 0 

SP+04 -~ PS of process prior to AST 
SP+02 -- PC of process prior to AST 
SP+00 -- DSW of process prior to AST 


The stack must be in this state when the AST SERVICE EXIT 
directive is executed, 
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CLEF$ 


4.2.5 CLEFS$ - CLEAR EVENT FLAG 


The CLEAR EVENT FLAG directive instructs the system to clear an 
indicated event flag and report the flag's polarity before clearing. 


Macro Call: 
CLEFS efn 
efn = Event flag number 
DSW Return Codes: 


IS.CLR -- Successful completion; flag was already clear 
_IS.SET -- §& ssful mpletion; fl t 






r 096 
IE.ADP Part of the DPB is out of 
address space 
IE.SDP -- DIC or DPB size is invalid 


Notes: 


@e VAX/VMS executes a Clear Event Flag system service on behalf 
of the image issuing the CLEAR EVENT FLAG directive. 


e A task image must be associated with common or group’ global 
event flags to access flags in the common or group global 
clusters (see Section 2.5). 


e Event flag conversion is as follows: 


Cluster RSX-11M VAX/VMS 
Local 1 through 32 32 through 63 
Common 33 through 64 64 through 95 


Group global 65 through 96 96 through 127 
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CMKTS 


4.2.6 CMKTS$ - CANCEL MARK TIME REQUESTS 


The CANCEL MARK TIME REQUESTS directive instructs the system to cancel 
all mark time requests that were made by the issuing image. 


Macro Call: 
CMKTS Te ge@rr] 
err = Error routine address 


DSW Return Codes: 


Is.SUC -- Successful completion 
IE.ADP -- Part of the DPB is out of the issuing image's 
address space 
IE.SDP -- DIC or DPB size is invalid 
Note: 


@e VAX/VMS executes a Cancel Timer Request’ system service 
specifying that all timer requests be canceled for the image 
issuing the CANCEL MARK TIME REQUESTS directive. 
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CRGF$ 


4.2.7 CRGF$ - CREATE GROUP GLOBAL EVENT FLAGS 


The CREATE GROUP GLOBAL EVENT FLAGS directive instructs the system to 
associate a named common event flag cluster with the process that 
issued the directive. If the named cluster does not exist, this 
directive instructs the system first to create the named cluster (with 
all flags initialized to 0) and then to associate it with the process 
that issued the directive. 


If a CREATE GROUP GLOBAL EVENT FLAGS directive is issued for an event 
flag cluster that has been marked for deletion (by the ELIMINATE GROUP 
GLOBAL EVENT FLAGS directive) but has not yet been deleted, the order 
for deletion is canceled. 
Macro Call: 

CRGFS$ [group] 

group = Group number for the flags to be created 


DSW Return Codes: 


IS.SUC 








IE.APD Part of the DPB is out of the issuing image's address 
space 
IE.DIC -- DIC or DPB size is invalid 
Notes: 


e VAX/VMS issues the Associate Common Event Flag Cluster system 
service on behalf of the image issuing the CREATE GROUP GLOBAL 
EVENT FLAGS directive. 


e A task image must be associated with common or _ group’ global 
event flags to access flags in the common or group global 
clusters (see Section 2.5). 


e Event flag conversion is as follows: 


Cluster RSX-11M VAX/VMS 
Local 1 through 32 32 through 63 
Common 33 through 64 64 through 95 


Group global 65 through 96 96 through 127 


e If a group number is specified in the macro call, it must 
match the group number specified in the task header of the 
image that issued the call; processes with the same _ group 
number then have access to the event flags that are created. 
If the group number is omitted from the macro call, the group 
number specified in the task header (H.CUIC) is used. 





4.2.8 
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CSRQ$ 


CSRQ$ - CANCEL TIME BASED INITIATION REQUESTS 





Macro Call: 


CSRQS tsk 






DSW Return Codes: 


IS.SUC -- Successful completion 
IE.INS -- Specified process name unknown (default error) 
IE.PRI -- Privilege violation (SS$_NOPRIV) 
IE.ADP -- Part of the DPB is out of the issuing image's 
address space 
IE.SDP -- DIC or DPB size is invalid 
Notes: 
e VAX/VMS executes a Cancel Wakeup system service on behalf of 


the image issuing the CANCEL TIME BASED INITIATION REQUESTS 
directive. 


The image issuing the CANCEL TIME BASED INITIATION REQUESTS 
directive must be executing in a process that meets either of 
the following requirements: 


-- It is in the same group as the process for which requests 
are to be canceled and has group privilege. 


-- It has world privilege. 


DIRECTIVE DESCRIPTIONS 


DECL$S 


4.2.9 DECLSS - DECLARE SIGNIFICANT EVENT 


The DECLARE 
declare a 










SIGNIFICANT EVENT dir 
Significant event. 


Macro Call: 


DECLSS [,err] 


err = Error routine address 
DSW Return Codes: 


IS.SUC -- Successful completion 
IE.ADP -- Part of the DPB is out of the issuing image's 
address space 
IE.SDP -- DIC or DPB size is invalid 
Note: 
e 


No operation is performed and a success status is returned. 
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DSARS$S 
or 
IHARS$S 


4.2.10 DSARS$S (or IHARS$S) - DISABLE (or INHIBIT) AST RECOGNITION 


The DISABLE AST RECOGNITION directive instructs the system to disable 
recognition of user-level ASTs for the issuing image. The ASTs are 
queued as they occur and are effected when the image enables AST 
recognition. When an AST service routine is executing, AST 
recognition also is disabled. The initial state of an image is to 
have recognition enabled. 


Macro Call: 
DSARSS__ [err] 
or 
IHARSS [err] 


err = Error routine address 


DSW Return Codes: 


IS.SUC -- Successful completion 

IE.ITS -- AST recognition is already disabled 

IE.ADP -- Part of the DPB is out of the issuing image's 
address space 

IE.SDP -- DIC or DPB size is invalid 


Note: 


e While disabled, ASTs are queued in a first-in/first-out list. 
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DSCP$S 


4.2.11 DSCP$S - DISABLE CHECKPOINTING 





Macro Call: 


DSCPSS_ [err] 


err Error routine address 


DSW Return Codes: 


IS.SUC -- Successful completion 
IE.ITS Swapping already disabled 













IE.ADP Part of the DPB is out of the issuing image's 
address space 
IE.SDP -- DIC or DPB size is invalid 
Notes: 


e VAX/VMS executes a Set Swap Mode system service on behalf of 
the image issuing the DISABLE CHECKPOINTING directive. 


e The image's initial state has swapping enabled. 


e The requesting image must have the privilege to set its swap 
mode. 
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ELGF$ 


4.2.12 ELGF$ - ELIMINATE GROUP GLOBAL EVENT FLAGS 
The ELIMINATE GROUP GLOBAL EVENT FLAGS directive instructs the system 


to dissociate the calling process from a named common event flag 
cluster. 


If no other processes are associated with a cluster thus marked _ for 
deletion, the cluster is deleted immediately. If, however, the 
cluster is still associated with other processes, it is not deleted 
until all of these processes are disassociated from the cluster. 
Macro Call: 

ELGFS [group] 


group = Group number of flags to be eliminated 


DSW Return Codes: 


IS.SUC 


Successful completion 





IE.ADP - Part of the DPB is out of the issuing image's address 
space 
IE.DIC -- DIC or DPB size is invalid 
Notes: 


e VAX/VMS issues the Disassociate Common Event Flag Cluster 
system service on behalf of the image issuing the ELIMINATE 
GROUP GLOBAL EVENT FLAGS directive. 


e A task image must be associated with common or _ group’ global 
event flags to access flags in the common or group global 
clusters (see Section 2.5). 


e Event flag conversion is as follows: 


Cluster RSX-11M VAX/VMS 

Local 1 through 32 32 through 63 
Common 33 through 64 64 through 95 
Group global 65 through 96 96 through 127 


e If a group number is specified in the macro call, it must 
match the group number’ specified in the task header of the 
image that issued the call. If the group number is omitted 
from the macro call, the group number specified in the task 
header (H.CUIC) is used. 
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ENARS$S 


4.2.13  ENARSS - ENABLE AST RECOGNITION 
The ENABLE AST RECOGNITION directive instructs the system to recognize 
user-level ASTs for the issuing image; that is, the directive 
nullifies a DISABLE AST RECOGNITION directive. ASTs that were queued 
while recognition was disabled are effected when the ENABLE AST 
RECOGNITION directive is issued. The initial state of an image is to 
have AST recognition enabled. 
Macro Call: 

ENARSS [err] 

err = Error routine address 


DSW Return Codes: 


IS.SUC -- Successful completion 

IE.ITS -- AST recognition is not disabled 

IE.ADP -- Part of the DPB is out of the issuing image's 
address space 

IE.SDP -- DIC or DPB size is invalid 
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ENCPS$S 


4.2.14 ENCPS$S - ENABLE CHECKPOINTING 





Macro Call: 
ENCPSS [err ] 


err = Error routine address 


DSW Return Codes: 


IS.SUC -- Successful completion 
S i 1 d bled 









IE.ADP Part of the DPB is out of the issuing image's 
address space 
IE.SDP -- DIC or DPB size is invalid 
Notes: 


@e VAX/VMS executes a Set Swap Mode system service on behalf of 
the image issuing the ENABLE CHECKPOINTING directive. 


e The image's initial state has swapping enabled. 


e The requesting image's process must have the PSWAPM privilege 
to set its swap mode. 
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EXIFS 


4.2.15 EXIFS - EXIT IF 
The EXIT IF directive instructs the system to terminate execution of 
the issuing image if the specified event flag is not set. VAX/VMS 
returns control to the issuing image if the specified event flag is 
set. 
Macro Call: 

EXIFS efn 

efn = Event flag number 


DSW Return Codes: 


IS.SET - Indicated event flag is set; image did not exit 











Part of the DPB is out of the issuing 
address space 
-~- DIC or DPB size is invalid 





e A task image must be associated with common or group’ global 
event flags to access flags in the common or group global 
clusters (see Section 2.5). 


e Event flag conversion is as follows: 


Cluster RSX-11M VAX/VMS 

Local 1 through 32 32 through 63 
Common 33 through 64 64 through 95 
Group global 65 through 96 96 through 127 
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EXIT$S 


4.2.16 EXITSS - TASK EXIT 


The TASK EXIT directive instructs the system to terminate execution of 
the issuing image. 


Macro Call: 
EXITSS [err] 
err = Error routine address 


DSW Return Codes: 


IE.ADP -- Part of the DPB is out of the issuing image's 
address space 
IE.SDP -- DIC or DPB size is invalid 
Notes: 


e A return to the image occurs only if the directive is 
rejected. 


@ VAX/VMS executes an Exit system service on behalf of the 
issuing image. The success status is returned. 
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EXST$ 


4.2.17 EXSTS - EXIT WITH STATUS 

The EXIT WITH STATUS directive instructs the system to terminate 
execution of the issuing image and to accept from the image a status 
code indicating whether the termination is normal or abnormal. 


Macro Call: 


EXSTS sts[,err] 


sts = exit status 
EXSSUC -- Normal termination (RSX$_EXITSTATUS) 
EXSWAR -- Warning (RSX$_EXITSTATUS) 
EXSERR -- Abnormal termination (RSXS_EXITSTATUS) 
EXSSEV -- Severe error termination (RSXS_EXITSTATUS) 
err = Error routine address 


DSW Return Codes: 


IE.ADP -- Part of the DPB is out of the issuing image's 
address space 
IE.SDP -- DIC or DPB size is invalid 
Notes: 


e A return to the image occurs only if the directive is 
rejected. 


e VAX/VMS executes an Exit system service specifying the exit 
status of the image. 
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EXTK$ 


4.2.18 EXTKS$ - EXTEND TASK 


The EXTEND TASK directive instructs the system to modify the size of 
the issuing task by a= positive or negative increment of 32-word 
blocks. If the directive does not specify an increment value, VAX/VMS 
makes the issuing image's size equal to its initial size. 


Macro Call: 
EXTKS [inc] 


inc = A positive or negative number equal to the number of 
32-word blocks by which the image size is_ to be 
extended or reduced 


DSW Return Codes: 


IS.SUC -- Successful completion 

IE.ALG -- The issuing image attempted to reduce its size 
to less than the size of its header; or the 
image tried to increase its size beyond 32K 
words or beyond the base of the lowest mapped 
library or common block 


IE.ADP -- Part of the DPB is out of the issuing image's 
address space 
IE.SDP -- DIC or DPB size is invalid 
Notes: 


e An image cannot extend itself past its 65K byte address' space 
or, if libraries or common areas are present, past the base of 
the lowest mapped library or common block. 


e An image can extend itself to the base of its read-only 
section. 
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GLUNS 


4.2.19 GLUNS - GET LUN INFORMATION 

The GET LUN INFORMATION directive instructs the system to fill a 
6-word buffer with information about a physical device unit to which a 
LUN is assigned. 

Macro Call: 


GLUNS lun, buf 


lun = Logical unit number 
buf = Address of 6-word buffer that is to receive the LUN 
information 


Buffer Format: 
WD. 00 Name of assigned device 


WD. O1 Unit number of assigned device in the low-order byte 






h ig 

WD. 02 First device characteristics word: 
Bit 0 -- Record-oriented device (l=yes) [FD.REC]1 
Bit 1 -- Carriage-control device (l=yes) [FD.CCL] 
Bit 2 -- Terminal device (l=yes) [FD.TTY] 
Bit 3 -- Directory device (l=yes) [FD.DIR] 
Bit 4 -- Single directory device (l=yes) [FD.SDI] 
Bit 5 -- Sequential device (l=yes) [FD.SQD] 





Bit 14 -- Device mountable as a Files-1ll device 
(l=yes) 
Bit 15 -- Device mountable (l=yes) 


WD. 03, 04 





WD. 05 Standard device buffer size 





1. Bits with associated symbols have the symbols shown in_= square 
brackets. These symbols can be defined for use by an image by means 
of the FCSBTS macro. See the IAS/RSX-11 I/0 Operations Reference 
nee Boy PORT Pe ee al eee ee eee 
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DSW Return Codes: 


IS.SUuC -- Successful completion 

IE.ULN -- Unassigned LUN 

IE.ILU -- Invalid logical unit number 

IE.ADP -~-- Part of the DPB or buffer is out of the issuing 
image's address space 

IE.SDP -- DIC or DPB size is invalid 

Notes: 
e VAX/VMS executes a Get Channel Information system service on 


behalf of the image issuing the GET LUN INFORMATION directive. 


VAX/VMS converts the name and unit number of the VAX/VMS 
device to which the LUN is assigned to an RSX-11M device name 
and unit number before returning the LUN information. 


To convert from a VAX/VMS device name to the RSX-11M_ form, 
VAX/VMS subtracts the value representing the ASCII character A 
(65) from the value of the ASCII character representing’ the 
controller letter and multiplies the result by 16 (decimal). 
It then adds the VAX/VMS unit number. The final result iS an 
RSX-11M unit number that is appended to the 2-character device 
name. For example, the VAX/VMS device name TTA2 converts’ to 
the RSX-11M device name TT2. 


TTA2 to TT2: 
Unit = (‘'A'-'A')*164+2 = 0*164+2 = 2 


If the device to which the LUN is assigned is a spooled device 
(for example, a line printer), VAX/VMS returns’ the 
characteristics of the intermediate device (for example, 
disk). 


Mailboxes have 16-bit unit numbers. The low-order 8 bits are 
returned by GET LUN INFORMATION in word 1. Mailboxes must be 
referred to using a logical name rather than using the unit 
number returned. 


DIRECTIVE DESCRIPTIONS 


GMCR$ 


4.2.20 GMCRS$ - GET MCR COMMAND LINE 


The GET MCR COMMAND LINE directive instructs the system to transfer an 
80-byte command line to the issuing image. It is the command line 
used to invoke the image. As a result, it can be in either MCR or DCL 
format. 


Macro Call: 
GMCRS 
DSW Return Codes: 


+n -- Successful completion; nis the number of data 
bytes transferred, excluding the termination 
character. The termination character is, 
however, in the buffer 
IE.AST -- No command line exists for the issuing image; 
that is, the image was not requested by a 
command other than RUN or the image has’ already 
issued the GET MCR COMMAND LINE directive 


IE.ADP -- Part of the DPB is out of the issuing process's 
address space 
IE.SDP -- DIC or DPB size is invalid 
Notes: 


e The system processes all lines to: 
-- Convert tabs to a single space 
-- Convert multiple spaces to a single space 
-- Convert lowercase characters to uppercase 
-- Remove all trailing blanks 
The terminator <CR> is the last character in the line. 


e The command line can be the result of the following types of 
user-issued DCL commands: 


Format Example 
$ MCR name command-string $ MCR PIP LP:=MYFILE 
$ MCR $ MCR 
MCR> name command-string MCR>PIP LP:=MYFILE 


e The command line can be the result of he following types of 
MCR commands: 


Format Example 
>name command-string >PIP LP:=MYFILE 
>name >PIP 

followed by prompt PIP> 


DIRECTIVE DESCRIPTIONS 


The command line received as a result of the GET MCR COMMAND 
LINE directive varies depending on the format of the command 
typed. If the command contains a command string, for example, 
LP:=MYFILE, that string and its length are available to the 
image. If no string is supplied, VAX/VMS returns a command 
string length of zero. 


When an image executes aS a result of a RUN command (either 
DCL or MCR), the command line length is zero. 


DIRECTIVE DESCRIPTIONS 


GPRT$ 


4.2.21 GPRT$ - GET PARTITION PARAMETERS 


The GET PARTITION PARAMETERS directive instructs the system to fill an 
indicated 3-word buffer with partition parameters. e 





Macro Call: 


GPRTS [prt] ,buf 


u 


prt 
buf 


Partition name 
Address of a 3-word buffer 


The buffer has the following format: 





DSW Return Codes: 


Successful completion is indicated by carry clear and SDSW equal to 0 
indicating a mapped system. 


IE.ADP -- Part of the DPB or buffer is out of the issuing 
image's address space 
IE.SDP -- DIC or DPB size is invalid 


DIRECTIVE DESCRIPTIONS 


GTIM$ 


4.2.22 GTIMS - GET TIME PARAMETERS 
The GET TIME PARAMETERS directive instructs the system to fill an 
indicated 8-word buffer with the current time parameters. All time 
parameters are delivered as binary numbers. The value ranges are 
Shown in decimal below. 
Macro Call: 

GTIMS buf 

buf = Address of 8-word buffer 


The buffer has the following format: 





WD. 0 -- Year (since 1900) 
WD. 1 -- Month (1-12) 

WD. 2 -- Day (1-31) 

WD. 3 -~ Hour (0-23) 

WD. 4 -- Minute (0-59) 

WD. 5 Second (0-59) 





DSW Return Codes: 


IS.SUC -- Successful completion 
IE.ADP -- Part of the DPB or buffer is out of the issuing 
image's address space 
IE.SDP -- DIC or DPB size is invalid 
Notes: 


e VAX/VMS executes a Get Time system service for the image 
issuing the GET TIME PARAMETERS directive. 


@ VAX/VMS provides a 100 tick-per-second clock. 


DIRECTIVE DESCRIPTIONS 


GTSK$ 


4.2.23 GTSKS - GET TASK PARAMETERS 
The GET TASK PARAMETERS directive instructs the system to fill an 
indicated 16-word buffer with parameters relating to the issuing 
process. 
Macro Call: 
GTSKS buf 
buf = Address of a 16-word buffer 


The buffer has the following format: 











04 ndef 
WD. 05 -- Undefined 
WD. 08 -- Number of logical I/O units (LUNs) 
WD. 09 -- Undefined 
WD. 10 -- Undefined 
WD. 11 -- Address of task SST vector tables 
WD. 12 -- Size of task SST vector table in words 
WD. 13 -- Size in bytes of image's address window excluding 





and co 





DSW Return Codes: 


IS.SUC -- Successful completion 

IE.ADP -- Part of the DPB or buffer is out of the issuing 
image's address space 

IE.SDP -- DIC or DPB is invalid 
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DIRECTIVE DESCRIPTIONS 


MRKT$ 


4.2.24 MRKTS - MARK TIME 


The MARK TIME directive instructs the system to set an event flag 
and/or declare an AST after an indicated time interval. The interval 


begins when the image issues the directive. If an event flag is 
specified, the flag is cleared when the directive is issued and set 
when the interval elapses. If an AST entry point address is 


specified, an AST occurs when the interval elapses. 
Macro Call: 


MRKTS [efn],tmg,tnt[,ast] 


efn = Event flag number 
tmg = Time interval magnitude 
tnt = Time interval unit 
ast = AST entry point address 


DSW Return Codes: 


IS.SUC -- Successful completion 
Invalid time parameter 










Insufficient 


address space 
IE.SDP -- DIC or DPB size is invalid 





image's 


Notes: 


@e VAX/VMS executes a Set Timer system service on behalf of the 
process issuing the MARK TIME directive. 


e If an AST entry point address is specified, the AST service 
routine is entered with the stack in the following state: 


SP+08,14 - 0 

SP+06 - PS of process prior to AST 

SP+04 - PC of process prior to AST 

SP+02 - DSW of process prior to AST 

SP+00 - Event flag number or 0 (if none was 


specified in the MARK TIME directive) 


The event flag number must be removed from the stack before an 
AST SERVICE EXIT directive is executed. 


DIRECTIVE DESCRIPTIONS 


VAX/VMS returns the DSW code IE.ITI if the directive specifies 
an invalid time parameter. The time parameter consists of two 
components: the time interval magnitude (tmg) and the time 
interval unit (tnt). 


A legal magnitude value (tmg) is related to the value assigned 
to the time interval unit (tnt). The unit values are encoded 
as follows: 


1 = Ticks (1/100 of a second per tick) 
2 = Seconds 
3 = Minutes 


4 = Hours 
The magnitude (tmg) is the number of units to be clocked. The 
following list describes the magnitude values that are valid 
for each type of unit. In no case can the value of tmg exceed 
24 hours. 


If tnt = 0, 1, or 2, tmg can be any positive value with a 
maximum of 15 bits. 


If tnt = 3, tmg can have a maximum value of 1440(10). 

If tnt = 4, tmg can have a maximum value of 24(10). 
A task image must be associated with common or _ group’ global 
event flags to access flags in the common or group global 


clusters (see Section 2.5). 


Event flag conversion is as follows: 


Cluster RSX-11M VAX/VMS 

Local 1 through 32 32 through 43 
Common 33 through 64 64 through 95 
Group global 65 through 96 96 through 127 


VAX/VMS enforces a quota on the number of ASTs that a _ process 
can have pending. 


DIRECTIVE DESCRIPTIONS 


QIO$ 


4.2.25 QIO$S —- QUEUE I/O REQUEST 


The QUEUE I/O REQUEST directive instructs the system to place an 1/0 
request for an indicated physical device unit into a queue of 
priority-ordered requests for that device unit. The physical device 
unit is specified as a logical unit number (LUN). 


If the directive call specifies an event flag, VAX/VMS clears the flag 
when the request is queued and sets the flag upon request completion. 


The I/O status block is also cleared when the request is queued, and 
set to the final I/O status when the I/O request is complete. If an 
AST service routine entry point address is specified, the AST occurs 
upon I/0 completion, and the process's WAITFOR mask word, PS, PC, DSW 
(directive status), and the address of the I/O status block are pushed 
onto the stack. 


Macro Call: 


QIOSs fne,lun,[efn], [pri], {isb],[ast][,prl] 
fne = I/0 function code 
lun = Logical unit number 
efn = Event flag number 
pri = Priority; ignored, but must be present 
isb = Address of I/O status block 
ast = Address of AST service routine entry point 
prl = Parameter list of the form <Pl,...,P4> 


DSW Return Codes: 





IS.SUC -- Successful completion 
IE.ULN Unassigned LUN 
IE.ILU Invalid LUN 





IE.ADP - Part of the DPB or I/O status block is out of the 
issuing image's address space 
IE.SDP -- DIC or DPB size is invalid 
Notes: 


e VAX/VMS executes a Queue I/O Request system service on behalf 
of the image issuing the QUEUE I/O REQUEST directive. 


e Chapter 5 explains function codes, parameter meanings, and I/0 
status block return values. 


DIRECTIVE DESCRIPTIONS 


If the directive call specifies an AST entry point address, 
the process enters the AST service routine with the stack in 
the following state: 


SP+16 - SP+10 - 0 

SP+06 - PS of process prior to AST 

SP+04 - PC of process prior to AST 

SP+02 - DSW of process prior to AST 

SP+00 - Address of I/O status block, or zero if none 
was specified in the QIO directive. 


The address of the I/O status block, which is a trap-dependent 
parameter, must be removed from the stack before an AST 
SERVICE EXIT directive is executed. 


VAX/VMS pushes four words of zeros in SP+l16~ through SP+10. 
RSX-11M pushes three words with undefined contents and a 
l-word event flag mask. 


If the directive is rejected, the specified event flag is not 
guaranteed to be cleared or set. Therefore a process that 
waits for a rejected QUEUE I/O REQUEST AND WAIT directive may 
wait forever. 


A task image muSt be associated with common or group’ global 
event flags to access flags in the common or group global 
clusters (see Section 2.5). 


Event flag conversion is as follows: 


Cluster RSX-11M VAX/VMS 

Local 1 through 32 32 through 43 
Common 33 through 64 64 through 95 
Group global 65 through 94 96 through 127 


VAX/VMS enforces a quota on the number of ASTs that a process 
can have pending. 


DIRECTIVE DESCRIPTIONS 


QIOWS 


4.2.26 QIOWS - QUEUE I/O REQUEST AND WAIT 


The QUEUE I/O REQUEST AND WAIT directive is identical to QUEUE I/0 
REQUEST with one exception: if the wait variation of the directive 
specifies an event flag, VAX/VMS automatically effects a WAIT FOR 
SINGLE EVENT FLAG directive. If an event flag is not specified, 
however, VAX/VMS treats the directive as if it were a QUEUE I/0 
REQUEST. 


Macro Call: 


QIOWS fne,lun,efn, [pri], (isb],[ast][,prl] 


fne = I/0 function code 

lun = Logical unit number 

efn = Event flag number 

pri = Priority; ignored, but must be present 
isb = Address of I/O status block 

ast = Address of AST service routine entry point 
prl = Parameter list of the form <Pl,...,P6> 


DSW Return Codes: 


IS.SUC -- Successful completion 
IE.ULN Unassigned LUN 


IE.ILU Invalid LUN — 





IE.ADP -- Part of the DPB or I/O status block is out of the 
issuing image's address space 
IE.SDP -- DIC or DPB size is invalid 


Note: 
e VAX/VMS executes a Queue I/O Request and Wait for Event Flag 
system service on behalf of the image issuing the QUEUE I/O 
REQUEST AND WAIT directive. 


e See the notes for the QUEUE I/O REQUEST directive. 
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DIRECTIVE DESCRIPTIONS 


RCST$ 


4.2.27 RCST$ - RECEIVE DATA OR STOP 





A 2-word sending process name in Radix-50 form and the 13-word data 
block are returned in a 15-word buffer. 


Macro Call: 


RCSTS [tname] ,buf 









buf Address of 15-word buffer 
DSW Return Codes: 


Is.suCc - 





Successful completion; data read from mailbox 








NSFMEM 





IE.SET - No data obtained from mailbox or no mailbox exists; 
process stopped 

IE.AST -~- Directive was issued from an AST service routine and 
no data obtained from mailbox or no mailbox exists 

IE.ADP -- Part of the DPB is out of the issuing image's address 
space 

IE.SDP -- DIC or DPB size is invalid 

Notes: 


e VAX/VMS executes a Queue I/O Request system service and, if 
appropriate, a Hibernate system service on behalf of the 
process issuing the RECEIVE DATA OR STOP directive. The I/0 
operation reads data from a mailbox associated with the 
process by VAX/VMS when it loaded the image. 


e The name of the mailbox is RCVD followed by the process name, 
that is, RCVDname. 


e The mailbox is not created until the image actually begins’ to 
execute. 


e The image issuing the receive directive must have a name 
specified at task-build time; that is, the image label block 
must contain a task name. VAX/VMS uses the presence of the 
task name as a indication that the image may receive data and 
sets up the necessary machanism. 


e Because the protection of the mailbox is specified as_ read 
access’ for the owner (receiving process) and write access for 
the group (sending processes), this directive is useful only 
for pasSing data between processes within the same group. 


DIRECTIVE DESCRIPTIONS 


If no data is obtained from the mailbox or if no mailbox 
exists, VAX/VMS executes a Hibernate system service for the 
process that issued the RECEIVE DATA OR STOP directive, and a 
Status code of IS.SET is returned. Note that the status code 
IS.SET cannot be seen by the process that issues the directive 
until the process is restarted by an UNSTOP TASK directive (a 
Wake system service). 


If a process issued the RECEIVE DATA OR STOP directive and 
stops because no data is available in the mailbox, the process 
is not automatically awakened later when data is placed into 
the mailbox. A task sending data should also wake the stopped 
task using the UNSTOP TASK directive; to receive the data, 
the awakened task must issue another receive-data directive 
(RECEIVE DATA, RECEIVE DATA OR EXIT, or RECEIVE DATA OR STOP). 


DIRECTIVE DESCRIPTIONS 


RCVD$ 


4.2.28 RCVDS$ - RECEIVE DATA 





A 2-word sending process name in Radix-50 form and the 13-word data 
block are returned in a 15-word buffer. 


Macro Call: 
RCVDS [tsk],buf 


buf Address of 15-word buffer 








DSW Return Codes: 





IE.ITS No data 


mailbox (default error) 

IE.ADP -- Part of the DPB or buffer is out of the issuing 
image's address space 

IE.SDP -- DIC or DPB size is invalid 


Notes: 


e VAX/VMS executes a read Queue I/O Request system service on 
behalf of the process issuing the RECEIVE DATA directive. The 
I/O operation reads data from a mailbox associated with the 
process by VAX/VMS when it loads the image. 


e The name of the mailbox is RCVD followed by the process name, 
that is, RCVDname. 


e The mailbox is not created until the image actually begins’ to 
execute. 


@® Because protection is specified as read access for the owner 
(receiving process) and write access for the group (sending 
processes), this directive is useful only for passing data 
between processes within the same group. 


e The image issuing the receive directives must have a name 
specified at task-build time; that is, the image label block 
must contain a task name. VAX/VMS uses the presence of the 
task name as an indication that the image may receive data and 
sets up the necessary mechanism. 


4.2.29 


DIRECTIVE DESCRIPTIONS 


RCVXS$ 


RCVX$ - RECEIVE DATA OR EXIT 





A 2-word sending process name in Radix-50 form and the 13-word data 
block are returned in a 15-word buffer. 


Macro Call: 


RCVX$ [tsk] ,buf 


buf 





DSW Return Codes: 







IS.SUC 


IE.ADP 


Part of the DPB or buffer is out of the issuing 
image's address space 


IE.SDP -- DIC or DPB size is invalid 
Notes: 
e VAX/VMS executes a Queue I/O Request system service and, if 


appropriate, an Exit system service on behalf of the process 
issuing the RECEIVE DATA OR EXIT directive. The I/O operation 
reads data from a mailbox associated with the process by 
VAX/VMS when it loaded the image. 


The name of the mailbox is RCVD followed by the process name, 
that is, RCVDname. 


The mailbox is not created until the image actually begins’ to 
execute. 


BecauSe protection is specified as read access for the owner 
(receiving process) and write access for the group (sending 
processes), this directive is useful only for passing data 
between processes within the same group. 


If no data is obtained from the mailbox, VAX/VMS executes” an 
Exit system service for the image. The exit status is 
SS$_NORMAL. 


The image issuing the receive directives must have a name 
specified at task~build time; that is, the image label block 
must contain a task name. VAX/VMS uses the presence of the 
task name as an indication that the image may receive data and 
sets up the necessary mechanism. 


This directive does not provide the same interlock between the 
sender and the receiver as it does in RSX-11M. 


If no mailbox exists, the image exits with a success status. 


DIRECTIVE DESCRIPTIONS 


RDAF$ 


4.2.30 RDAFS$ - READ ALL EVENT FLAGS 

The READ ALL EVENT FLAGS directive instructs the system to read local 
and common event flags for the issuing process and record their values 
in a 64-bit (4-word) buffer. 

Macro Call: 


RDAFS buf 


The buffer has the following format: 


WD. 00 -- Local flags 1 through 16 

WD. 01 -~- Local flags 17 through 32 
WD. 02 -- Common flags 33 through 48 
WD. 03 -- Common flags 49 through 64 


DSW Return Codes: 


IS.SUC -- Successful completion 
IE.ADP -- Part of the DPB or buffer is out of the issuing 
image's address space 
IE.SDP -- DIC or DPB size is invalid 
Notes: 


e VAX/VMS issues a Read Event Flags system service on behalf of 
the image issuing the READ ALL EVENT FLAGS directive. 


e The READ ALL EVENT FLAGS directive does not read group global 
flags. The READ EXTENDED EVENT FLAGS directive reads all 9f 
flags. 





e A task image must be associated with common flags to access 
flags in the common cluster (see Section 2.5). 


e Event flag conversion is as follows: 


Cluster RSX-11M VAX/VMS 
Local 1 through 32 32 through 63 
Common 33 through 64 64 through 95 


DIRECTIVE DESCRIPTIONS 


RDXF$ 


4.2.31 RDXFS - READ EXTENDED EVENT FLAGS 
The READ EXTENDED EVENT FLAGS directive instructs the system to read 
all local, common, and group global event flags for the issuing 
process and to record their values in a 96-bit (6-word) buffer. 
Macro Call: 
RDXFS$ buf 
buf = Address of 6-word buffer 


The buffer has the following format: 


WD. 00 = Local flags 1 through 16 

WD. O01 = Local flags 17 through 32 

WD. 02 = Common flags 33 through 48 

WD. 03 = Common flags 49 through 64 

WD. 04 = Group global flags 65 through 80 
WD. 05 = Group global flags 81 through 96 


DSW Return Codes: 


IS.SUC -- Successful completion 
IS.CLR -- Group global event flags do not exist. Words 4 and 5 
of the buffer contain zeros 
IE.ADP -- Part of the DPB or buffer is out of the issuing 
image's address space 
IE.SDP -- DIC or DPB size is invalid 
Notes: 


e VAX/VMS issues the Read Event Flags system service on _ behalf 
of the image issuing the READ EXTENDED EVENT FLAGS directive. 


e A task image must be associated with common or _ group’ global 
event flags to access flags in the common or group global 
clusters (see Section 2.5). 


e Event flag conversion is as follows: 


Cluster RSX-11M VAX/VMS 

Local 1 through 32 32 through 63 
Common 33 through 64 64 through 95 
Group global 65 through 96 96 through 127 





e If no group global event flag cluster is associated with the 
process, the group global event flags are returned as all 
zeros and IS.CLR is returned. 


DIRECTIVE DESCRIPTIONS 


RQST$ 


4.2.32 RQST$ - REQUEST TASK 






1 





Chapter 2 describes the use of the Hibernate and 
Wake system services for real-time images. 


REQUEST TASK is a frequently used subset of the RUN directive. 


Macro Call: 


ROSTS tsk, [prt], [pri] [,ugc,umc] 


| 


ed 









prt Partition name; ignor 


DSW Return Codes: 


IS.SUC Successful completion 


wb EO lame not known (def 





S 





IE.ADP -- Part of the DPB is out of the issuing image's 
address space 
IE.SDP -- DIC or DPB size is invalid 
Notes: 


e VAX/VMS executes a Wake system service on behalf of the 
process issuing the REQUEST TASK directive. 


e The requested process must currently be present in the system; 
that is, either hibernating or active. 


e The image issuing the REQUEST TASK directive must be executing 
in a process that meets either of the following requirements: 


-- It is in the same group as the requested process and has 
group privilege. 


-- It has world privilege, 


@ VAX/VMS maintains an indicator to determine whether any wake 
requests have been issued for an active process. If the 
pending wake indicator is set and the process issues a 
hibernate request, the process remains active, and the pending 
wake indicator is cleared. A subsequent hibernate’ request 
causes the process to hibernate. 


e Hibernations that are caused by STOP directives (RECEIVE DATA 
OR STOP, STOP, STOP FOR LOGICAL OR OF EVENT FLAGS, and STOP 
FOR SINGLE EVENT FLAG) cannot be reactivated by the REQUEST 
TASK directive. 


4.2.33 





SS SAN 


SSN 


DIRECTIVE DESCRIPTIONS 


RSUM$ 


RSUMS$ - RESUME TASK 


Macro Call: 


RSUM$ tsk 





DSW Return Codes: 


IS.SUC -- Successful completion 
IE.INS Process name unknown (default error) 





IE.ADP - Part of the DPB is out of the issuing image's 
address space 
IE.SDP -- DIC or DPB size is invalid 
Notes: 
e VAX/VMS executes a Wake system service on behalf of the 


process issuing the RESUME TASK directive. 


The image issuing the RESUME TASK directive must be executing 
in a process that meets either of the following requirements: 


-- It is in the same group as the process to be resumed and 
has group privilege. 


-- It has world privilege. 


VAX/VMS maintains an indicator to determine whether any wake 
requests have been issued for an active process. If the 
indicator is set and the process issues a hibernate request, 
the process remains active, and the indicator is cleared. A 
subsequent hibernate (SUSPEND) request causes the process’ to 
hibernate. 


If a RESUME TASK directive is issued for an image that is 
active, the status returned is success. The process remains 
active. 


Hibernations that are caused by STOP directives (RECEIVE DATA 
OR STOP, STOP, STOP FOR LOGICAL OR OF EVENT FLAGS, and STOP 
FOR SINGLE EVENT FLAG) cannot be reactivated by the RESUME 
TASK directive. 


RUNS 


4.2.34 







delta 







time from 
omitted, RUN TASK is the same as REQUEST TASK 


DIRECTIVE DESCRIPTIONS 


RUNS - RUN TASK 






“ut ti 
The schedu 
issuance, If the smg, rmg, 





, optionally 
ime is specifie 





in ermS oO 
and rnt parameters are 


except that RUN TASK 


causes the process to become active one clock tick after the directive 
is issued. 


Macro Call: 


RUNS 





“sig 









Cc 
Partition name; 
Priorit i 


ignored 









ene Saas cp 
eita magnitude 





snt = Schedule delta unit 
rmg = Reschedule interval magnitude 
rnt = Reschedule interval unit 


DSW Return Codes: 


IS.SUC -- Successful completion 









_IE.INS 





Process name unknown 


tsk, [prt],[pri],{ugc],[umc],[smg],snt[,rmg,rnt] 






ssuing image's 


must be executing in 


“IE.ITI Invalid time parameter 
IE.ADP -- Part of the DPB is out of the i 
address space 
IE.SDP -- DIC or DPB size is invalid 
Notes: 
e VAX/VMS executes a Schedule Wakeup system service on behalf of 
the process issuing the RUN TASK directive. 
e The target process must be present in the system, 
e The image issuing the RUN TASK directive 
a process that meets either of the following requirements: 
-~- It is in the same group as the process to be run and has 
group privilege. 
-- It has world privilege. 
e 


VAX/VMS maintains an indicator to determine whether any wake 


requests have been issued for an active 
pending indicator is set and the process 
request, the process remains active, 
indicator is cleared. A subsequent 
request causes the process to hibernate. 


process. If the wake 
issues a hibernate 
and the wake pending 
hibernate (SUSPEND) 


DIRECTIVE DESCRIPTIONS 


VAX/VMS returns the DSW code IE.ITI if the directive specifies 
an invalid time parameter. A time parameter consists of two 
components: the time interval magnitude (smg or rmg) and the 
time interval unit (Snt or rnt). 


A legal magnitude value (smg or rmg) is related to the value 
assigned to the time interval unit = snt or rnt. The unit 
values are encoded as follows: 

1 = Ticks (1/100 of a second per tick) 

2 = Seconds 

3 = Minutes 

4 = Hours 
The magnitude is the number of units to be clocked. The 
following list describes the magnitude values that are valid 


for each type of unit. In no case can the magnitude exceed 24 
hours. 


If unit = 0,1, or 2, the magnitude can be any positive 
value with a maximum of 15 bits. 


If unit = 3, the magnitude can have a maximum value of 
1440(10). 

If unit = 4, the magnitude can have a maximum value of 
24(10). 


The schedule delta time is the difference in time from the 
issuance of the RUN TASK directive to the time the process is 
to be run. This time can be specified in the range from one 
clock tick to 24 hours. 


Hibernations that are caused by STOP directives (RECEIVE DATA 
OR STOP, STOP, STOP FOR LOGICAL OR OF EVENT FLAGS, and STOP 
FOR SINGLE EVENT FLAG) cannot be reactivated by the RUN TASK 
directive. 


DIRECTIVE DESCRIPTIONS 


SDATS$ 


4.2.35 SDATS —- SEND DATA 





When an event flag is specified in the SEND DATA directive, the 
indicated flag is set for the sending process. 


Macro Call: 


SDATS tsk,buf[,efn] 






buf = Address of 13-word data buffer 
efn Event flag number 


DSW Return Codes: 


IS.SUC -- Successful completion 
IE.INS -- Receiver process name unknown (default error) 









IE.ADP - Part of DPB or data block is out of the issuing 
image's address space 
IE.SDP -- DIC or DPB size is invalid 
Notes: 


@e VAX/VMS executes a write Queue I/O Request system service on 
behalf of the process issuing the SEND DATA directive. The 
I/O operation writes to a mailbox named RCVD followed by _ the 
specified process name, that is, RCVDname. 


e The sending process must be in the same group as the receiving 
process because protection allows the group write access to 
the mailbox and denies access to the world. 


e The target process must be executing an image that had a name 
specified at task-build time; that is, the image label block 
must contain a task name. VAX/VMS uses the presence of the 
task name as an indication that the image may receive data and 
sets up the necessary mechanism. 


e A task image must be associated with common or group’ global 
event flags to access flags in the common or group global 
clusters (see Section 2.5). 


e Event flag conversion is as follows: 


Cluster RSX-11M VAX/VMS 

Local 1 through 32 32 through 63 
Common 33 through 64 64 through 95 
Group glohal &5 through 96 96 through 127 
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4.2.36 


DIRECTIVE DESCRIPTIONS 


SETFS 


SETFS$ - SET EVENT FLAG 


The SET EVENT FLAG directive instructs the system to set an indicated 
event flag and report the flag's previous value. 


Macro Call: 


SETFS efn 


efn = Event flag number 


DSW Return Codes: 


IS.CLR -- Flag was clear 
IS.SET - 





Flag was already set 





Note: 


IE.ADP 








Part of the DPB is out of the issuing image's 
address space 
IE.SDP -- DIC or DPB size is invalid 


VAX/VMS executes a Set Event Flag system service on behalf of 
the image issuing the SET EVENT FLAG directive. 


A task image must be associated with common or group’ global 
event flags to access flags in the common or group global 
clusters (see Section 2.5). 


Event flag conversion is as follows: 


Cluster RSX-11M VAX/VMS 

Local 1 through 32 32 through 63 
Common 33 through 64 64 through 95 
Group global 65 through 96 96 through 127 


DIRECTIVE DESCRIPTIONS 


SFPAS 


4.2.37 SFPAS - SPECIFY FLOATING-POINT PROCESSOR EXCEPTION AST 


The SPECIFY FLOATING-POINT PROCESSOR EXCEPTION AST directive instructs 
the system either to enable or disable delivery of floating-point 
processor exception ASTs. 


When an AST service routine entry point address is specified, future 
floating-point processor exception ASTs occur for the issuing process, 
and control is transferred to the indicated location at the time of 
the AST's occurrence. When an AST service entry point address is not 
specified, future floating-point processor exception ASTs do not occur 
until the image issues a directive that specifies an AST entry point. 


Macro Call: 
SFPAS [ast] 
ast = AST service routine entry point address 


DSW Return Codes: 


IS.SUC -- Successful completion 

IE.UPN -- Insufficient dynamic memory (SSS INSFMEM) 

IE.ITS -- AST entry point address is already unspecified 

IE.AST -- Directive was issued from an AST service routine 
or ASTS are disabled 

IE.ADP -- Part of the DPB is out of the issuing image's 
address space 

IE.SDP -- DIC or DPB size is invalid 

Notes: 


e The SPECIFY FLOATING-POINT PROCESSOR EXCEPTION AST requires 
dynamic memory. 


e VAX/VMS queues floating-point processor exception ASTsS when a 
floating-point processor exception trap occurs for the task. 
No future floating-point processor exception ASTS are queued 
for the process until the first one queued has actually been 
effected. 


e The floating-point processor exception AST service routine is 
entered with the task stack in the following state: 


SP+12 - Event flag mask word 

SP+10 - PS of task prior to AST 
SP+06 - PC of task prior to AST 
SP+04 - DSW of task prior to AST 
SP+02 - Floating exception code 
SP+00 - Floating exception address 


The image must remove the floating-point exception code and 
address from the stack before an AST SERVICE EXIT directive is 
executed. 


e This directive cannot be issued from an AST service routine or 
when ASTS are disabled. 


DIRECTIVE DESCRIPTIONS 


SPND$S 


4.2.38 SPNDSS - SUSPEND 











lo An image can suspend only the process in which 
- The suspended process can be restarted by another 
process that issues a RESUME directive for it. 





Macro Call: 
SPNDSS_ [err] 
err = Error routine address 
DSW Return Codes: 


IS.SUC - Successful completion 






IE.ADP - Part of the DPB is out of the issuing image's 
address space 
IE.SDP -- DIC or DPB size is invalid 


Notes: 


@e VAX/VMS executes a Hibernate system service on behalf of the 
process issuing the SUSPEND directive. 


e A suspended process retains control of the system resources 


allocated to it. VAX/VMS makes no attempt to free these 
resources. 


@e VAX/VMS maintains an indicator to determine whether any wake 
requests have been issued for an active process. If the 
indicator is set and the process issues a hibernate request, 
the process remains active, and the indicator is cleared. A 
subsequent hibernate request causes the process to hibernate. 


e If a SUSPEND directive is issued by an image that has’ pending 
resume requests, the following occurs. 


-- The status returned is success. 
-- The process remains active. 
-- The wake-pending indicator is cleared. 
e A process can be resumed only by specifying its process name; 
therefore, a process is not allowed to suspend itself unless 


it has a process name. 


e A process that is hibernating because of a SUSPEND directive 
cannot be reactivated by the UNSTOP TASK directive. 


DIRECTIVE DESCRIPTIONS 


SPRAS 


4.2.39 SPRAS$ - SPECIFY POWER RECOVERY AST 


The SPECIFY POWER RECOVERY AST directive instructs the system to 
record either of the following: 


e That power-recovery ASTs for the issuing process are required, 
and the address to which to transfer control when a powerfail 
recovery AST occurs 


e That power-recovery ASTs for the issuing process are no longer 
required 


When an AST service routine entry point address is specified, future 
power-recovery ASTs occur for the issuing process. VAX/VMS transfers 
control to the specified address whenever a powerfail recovery occurs. 
When an AST service entry point address is not specified, future 
power-recovery ASTs do not occur until an AST entry point is again 
specified. 
Macro Call: 
SPRAS [ast] 
ast = AST service routine entry point address 


DSW Return Codes: 


IS.SUC -- Successful completion 

IE.ITS -- AST entry point address is already unspecified 

IE.AST -- Directive was issued from an AST service routine 
or ASTsS are disabled 

IE.ADP -- Part of the DPB is out of the issuing image's 
address space 

IE.SDP -- DIC or DPB size is invalid 

Notes: 


e VAX/VMS executes a Set Power Recovery AST system service for 
the image issuing the SPECIFY POWER RECOVERY AST directive. 


e ASTs are disabled while the AST service routine executes. 
They remain disabled until the service routine issues an AST 
SERVICE EXIT directive. 


e The process enters the powerfail AST service routine with the 
task stack in the following state: 


SP+06,12 - 0 

SP+04 ~ PS of process prior to AST 
SP+02 - PC of process prior to AST 
SP+00 - DSW of process prior to AST 


No trap-dependent parameters accompany a power-recovery AST; 
therefore, the AST SERVICE EXIT directive can be executed with 
the stack in the same state as when the AST was effected. 


e This directive cannot be issued from an AST service routine or 
when ASTs are disabled. 


DIRECTIVE DESCRIPTIONS 


SPWNS 


4.2.40 SPWNS - SPAWN 





If the command line is not specified, the specified image is invoked 


and executed by the subprocess; its TI device is the TI of the parent 
process. 


ssa 


Macro Call: 





SPWNS tname,,,[ugc],[umc],[efn],[east],[esb],[cmdlin], 
{cmdlen], [unum] , [dnam] 





efn Event flag to be set when subprocess terminates 
east = Address of termination AST routine 
esb = Address of exit status block, an 8-word buffer 


containing the exit status in the first word; the 
other words are unused 


cmdlin = Address of command line to be executed; overrides 
image name specified in tname 
cmdlen = Length of command line 
unum = Unit number of TI device for process; if omitted, 
parent's TI is used 
dnam = Device name of TI device for process; if omitted, 


parent's TI is used 


DSW Return Codes: 


IS.SUC -- Successful completion 
Seas tencaeeiie 











Process name already exists 





se a 
Part of the DPB, exit status block, or command, 


is out of the issuing image's address space 
IE.SDP -- DIC or DPB size is invalid 





IE.ADP 
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DIRECTIVE DESCRIPTIONS 


SRDAS 


4.2.41 SRDAS - SPECIFY RECEIVE DATA AST 


The SPECIFY RECEIVE DATA AST directive instructs the system to. record 
either of the following conditions: 


e That receive-data ASTs for the issuing image are required, and 
the address to which to transfer control when data has been 
placed in the image's mailbox (RCVDprocessname) 


e That receive-data ASTs for the issuing task are no _ longer 
required 


When the directive specifies an AST service routine entry point 
address, receive-data ASTs for the image occur whenever data has been 


placed in the image's mailbox (RCVDprocessname). VAX/VMS transfers 
control to the specified address. 


When the directive omits an entry point address, VAX/VMS disables 
receive-data ASTs for the issuing image. Receive-data ASTs do not 
occur until the image issues another SPECIFY RECEIVE DATA AST 
directive that specifies an entry point address. 
Macro Call: 

SRDAS [ast] 


ast = AST service routine entry point address 


DSW Return Codes: 


IS.SUC -- Successful completion 

IE.ITS -- AST entry point address is already unspecified 

IE.AST -- Directive was issued from an AST service routine 
or ASTs are disabled 

IE.ADP -- Part of the DPB is out of the issuing image's 
address space 

IE.SDP -- DIC or DPB size is invalid 

Notes: 


e The task enters the receive-data AST service routine with the 
task stack in the following state: 


SP+06,12 - 0 

SP+04 - PS of process prior to AST 
SP+02 - PC of process prior to AST 
SP+00 - DSW of process prior to AST 


No trap-dependent parameters accompany a= receive-data AST; 
therefore, the AST SERVICE EXIT directive must be executed 
with the stack in the same state as when the AST was effected. 


e This directive cannot be issued from an AST service routine or 
when ASTS are disabled. 


DIRECTIVE DESCRIPTIONS 


VAX/VMS implements the SPECIFY RECEIVE DATA AST through the 
use of the set AST enable QIO I/O function for an unsolicited 
message to the mailbox. When a message is sent to the 
mailbox, an AST is given to the image. The AST is re-enabled 
by a subsequent AST SERVICE EXIT directive. 


Also refer to the section in this chapter on the RECEIVE DATA 
directive. 


DIRECTIVE DESCRIPTIONS 


STLO$ 


4.2.42 STLOS - STOP FOR LOGICAL OR OF EVENT FLAGS 

The STOP FOR LOGICAL OR OF EVENT FLAGS directive instructs the system 
to stop the execution of the issuing image until VAX/VMS sets one or 
more of the indicated local event flags from one of the _ following 
groups. 


GRO -- Flags 1 through 16 
GRl -- Flags 17 through 32 


The process does not stop if any of the indicated flags is already set 
when it issues the directive. 


This directive cannot be issued from an AST service routine. 

A process that is stopped because none of the indicated event flags is 
set can be restarted only when one or more of the specified event 
flags is set. Such a stopped process cannot become unstopped by means 
of an UNSTOP TASK directive. 

Macro Call: 


STLOS grp,msk 


grp -- Event flag group 
msk -- A 16-bit mask word 


DSW Return Codes: 


IS.SUC -- Successful completion 
IE.AST Directive was issued from an AST service routine 








IE.ADP Part of the DPB is out of the issuing image's address 
space 
IE.SDP -- DIC or DPB size is invalid 
Notes: 


e VAX/VMS executes a Wait for Logical OR of Event Flags_ system 
service on behalf of the image issuing the STOP FOR LOGICAL OR 
OF EVENT FLAGS directive. 

e A task image must be associated with common or group. global 
event flags to access flags in the common or group global 
clusters (see Section 2.5). 

e Event flag conversion is as follows: 

Cluster RSX-11M VAX/VMS 


Local 1 through 32 32 through 463 


4.2.43 





DIRECTIVE DESCRIPTIONS 


STOP$S 


STOPSS - STOP 


A process stopped by the STOP directive can be restarted only by an 
UNSTOP TASK directive issued by one of its own ASTs or by another 
process. 


Macro Call: 


STOPSS 


DSW Return Codes: 









IE.SET 





Successful completion 








.AST Directive was issued from an AST service routine 

IE.ADP -- Part of the DPB is out of the issuing image's address 

space 

IE.SDP -- DIC or DPB size is invalid 

Notes: 

e VAX/VMS executes a Hibernate system service on behalf of the 
process issuing the STOP directive. 

e A stopped process retains control of the system resources 
allocated to it. VAX/VMS makes no attempt to free these 
resources. 

@e VAX/VMS maintains an indicator to determine whether any wake 
requests have been issued for an active process. If the wake 
pending indicator is set and the process issues a hibernate 
request, the process remains active, and the wake pending 
indicator is cleared. A subsequent hibernate request causes 
the process to hibernate. 

Thus, if a STOP directive is issued by a process that has 
pending unstop requests, the following occurs: 
-- The status returned is success, 
-- The process remains active. 
-- The wake pending indicator is cleared, 
e A process stopped by use of the STOP directive can be 


restarted (by use of the UNSTOP TASK directive) only if its 
process name is’ specified; therefore, a process is not 
allowed to stop itself unless it has a process name. 
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DIRECTIVE DESCRIPTIONS 


STSE$ 


4.2.44 STSES$ - STOP FOR SINGLE EVENT FLAG 


The STOP FOR SINGLE EVENT FLAG directive instructs the system to’. stop 
the execution of .- the. issuing image until the specified local event 
flag is set. If the flag is set when the directive is issued, image 
execution continues. This directive cannot be issued from an AST 
service routine. 


A process that is stopped because a specified event flag is not’ set 
can be restarted only when that event flag is set. Such a stopped 
process cannot be restarted by means of an UNSTOP TASK directive. 
Macro Call: 

STSES efn 

efn = Event flag number 


DSW Return Codes: 


IS.SUC -- Successful completion 
IE.AST Directive was issued from an AST service routine 











IE.ADP Part of the DPB is out of the issuing image's address 
space 
IE.SDP -- DIC or DPB size invalid 
Notes: 


e VAX/VMS executes a Wait for Logical OR of Event Flags’ system 
service in behalf of the image issuing the STOP FOR SINGLE 
EVENT FLAG directive. 


e A task image must be associated with common or group global 
event flags to access flags in the common or group global 
clusters (see Section 2.5). 


e Event flag conversion is as follows: 


Cluster RSX-11M VAX/VMS 
Local 1 through 32 32 through 63 
Common 33 through 64 64 through 95 


Group global 65 through 96 96 through 127 


DIRECTIVE DESCRIPTIONS 


SVDB$ 


4.2.45 SVDBS - SPECIFY SST VECTOR TABLE FOR DEBUGGING AID 

The SPECIFY SST VECTOR TABLE FOR DEBUGGING AID directive instructs the 
system to record the address of a table of SST service routine entry 
points for use by an intra-image debugging aid (ODT, for example). 


To deassign the vector table, the parameters adr and len are omitted 
from the macro call. 


When an SST service routine entry is specified in both the table used 
by the image and the table used by a debugging aid, the trap occurs 
for the debugging aid, not for the image. 

Macro Call: 


SVDBS$ [adr] [,len] 


adr 
len 


Address of SST vector table 


Length of (that is, number of entries in) the table in 
words 


The vector table has the following format: 


WD. O00 -- Odd address or nonexistent memory error 

WD. O01 -- Memory protection violation 

WD. O02 -- T-bit trap or execution of a BPT instruction 
WD. 03 -- Execution of an IOT instruction 

WD. 04 -- Execution of an illegal or reserved instruction 
WD. 05 -- Execution of a non-RSX EMT instruction 

WD. O06 -- Execution of a TRAP instruction 

WD. O7 -- Not used 


A table entry with a value of 0 indicates that the image will not 
process the corresponding SST. 


DSW Return Codes: 


IS.SUC -- Successful completion 

IE.ADP -- Part of the DPB or table is out of the issuing 
image's address space 

IE.SDP -- DIC or DPB size is invalid 
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DIRECTIVE DESCRIPTIONS 


SVTK$ 


4.2.46 SVTKS - SPECIFY SST VECTOR TABLE FOR TASK 


The SPECIFY SST VECTOR TABLE FOR TASK directive instructs the system 
to record the address of a table of SST service routine entry points 
for use by the issuing image. 


To deassign the vector table, the parameters adr and len are omitted 
from the macro call. 


When an SST service routine entry is specified in both the table used 
by the image and the table used by a debugging aid, the trap occurs 
for the debugging aid, not for the image. 
Macro Call: 

SVTKS [adr] [,len] 
Address of SST vector table 


Length of (that is, number of entries in) the table in 
words 


adr 
len 


The vector table has the following format: 


WD.00 -- Odd address or nonexistent memory error 

WD.01 -- Memory protection violation 

WD.02 -- T-bit trap or execution of a BPT instruction 
WD.03 -- Execution of an IOT instruction 

WD.04 -- Execution of an illegal or reserved instruction 
WD.05 -- Execution of a non-RSX EMT instruction 

WD.06 -- Execution of a TRAP instruction 

WD.07 -- Not used 


A table entry with a value of 0 indicates that the image will not 
process the corresponding SST. 


DSW Return Codes: 


IS.SUC -- Successful completion 

IE.ADP -- Part of the DPB or table is out of the issuing 
image's address space 

IE.SDP -- DIC or DPB size is invalid 


DIRECTIVE DESCRIPTIONS 


USTPS$ 


4.2.47 USTPS$ - UNSTOP TASK 





An UNSTOP TASK directive restarts 
a specified process that has stopped itself by means of either a STOP 
directive or a RECEIVE DATA OR STOP directive. The UNSTOP TASK 
directive does not restart processes stopped for an event flag. 


If the UNSTOP TASK directive is issued to a process that is executing 
an AST service routine and if that process was previously stopped by 
either a STOP directive or by a RECEIVE DATA OR STOP directive, the 
process becomes unstopped only when the execution of the AST service 
routine has been completed. 

Macro Call: 


USTPS tname 
tname = VAX/VMS process name 
DSW Return Codes: 


IS.suc - Successful completion 











IE.ADP - Part of the DPB is out of the issuing image's address 
space 
IE.SDP -- DIC or DPB size is invalid 
Notes: 


e VAX/VMS executes a Wake system service on behalf of the 
process issuing the UNSTOP TASK directive. 


e The process issuing an UNSTOP TASK directive must meet one of 
the following requirements: 


It must have the same UIC as the process to be unstopped,. 


It must be in the same group as the process to be 
unstopped, and it must have the group privilege. 


Otherwise, a process needs no privileges to issue an UNSTOP 
TASK directive, It is the responsibility of the unstopped 
process to determine whether it has been validly awakened. 


@ VAX/VMS maintains an indicator to determine whether any wake 
requests have been issued for an active process. If the 
indicator is set and the process issues a hibernate’ request, 
the process remains active and the indicator is cleared. A 
subsequent hibernate request causes the process to hibernate. 


DIRECTIVE DESCRIPTIONS 
Thus, if a STOP directive is issued by a process that has 
pending unstop requests, the following occurs: 
The status returned is success, 
The process remains active. 
The wake-pending indicator is cleared. 
If an UNSTOP TASK directive is issued for an image that is 


active, the status returned is a success. The process remains 
active. 


DIRECTIVE DESCRIPTIONS 


WSIGS$S 


4.2.48 WSIGSS - WAIT FOR SIGNIFICANT EVENT 





Macro Call: 


WSIGSS [err] 


err Error routine address 


DSW Return Codes: 


IS.SUC -- Successful completion 

IE.ADP -- Part of the DPB is out of the issuing image's 
address space 

IE.SDP -- DIC or DPB size is invalid 
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DIRECTIVE DESCRIPTIONS 


WTLO$ 


4.2.49 


WTLOS - WAIT FOR LOGICAL OR OF EVENT FLAGS 


THE WAIT FOR LOGICAL OR OF EVENT. FLAGS directive instructs the system 
to block the execution of the issuing image until VAX/VMS sets an 
indicated event flag from one of the following groups. 


GRO -- Flags 1 through 16 
GR1l -- Flags 17 through 32 
GR 2 -- Flags 33 through 48 
GR 3 -- Flags 49 through 64 
GR 4 -- Flags 65 through 80 
GR 5 -- Flags 81 through 96 


The process does 


Macro Call: 


not wait if any of the indicated flags is already set 
when it issues the directive. 


WTLOS grp,msk 


grp 
msk 


DSW Return Codes: 


IE.ADP 


TE.SDP. == 


Notes: 


Part of the DPB 


Event flag group 
A 16-bit flag mask word 


address space 


DIC or DPB size 


is out of 


is invalid 





e VAX/VMS executes a Wait for Logical OR of Event Flags’ system 
service on behalf of the image issuing the WAIT FOR LOGICAL OR 
OF EVENT FLAGS directive. 


e A task image must be associated with common 


event flags 


access 


flags 


or group global 


in the common or group global 


clusters (see Section 2.5). 


Event flag conversion is as follows: 


Cluster RSX-11M VAX/VMS 

Local 1 through 32 32 through 63 
Common 33 through 64 64 through 95 
Group global 65 through 96 96 through 127 


The DSW status IE.IEF is returned if an image that does not 
have a common event flag cluster associated with it attempts 
to wait for flags 33 through 64. 


4.2.50 


DIRECTIVE DESCRIPTIONS 


WTSES 


WTSES - WAIT FOR SINGLE EVENT FLAG 


The WAIT FOR SINGLE EVENT FLAG directive instructs the system to block 
the execution of the issuing image until the indicated event flag is 


set. 


If the flag is set when the directive is issued, image execution 


continues. 


Macro Call: 


WTSES efn 


efn = Event flag number 


DSW Return Codes: 


IS.SUC 





Successful completion 


. art o e is ou fe) mag 
address space 





IE.SDP -- DIC or DPB size is invalid 
Notes: 
@ VAX/VMS executes a Wait for Logical OR of Event Flags’ system 


service in behalf of the image issuing the WAIT FOR SINGLE 
EVENT FLAG directive. 


A task image must be associated with common or group’ global 
event flags to access flags in the common or group global 
clusters (see Section 2.5). 


Event flag conversion is as follows: 


Cluster RSX-11M VAX/VMS 

Local 1 through 32 32 through 63 
Common 33 through 64 64 through 95 
Group global 65 through 96 96 through 127 


CHAPTER 5 


I/O DRIVERS 


VAX/VMS images request services directly from I/O drivers and ACPsS' by 
issuing Queue I/O Request macro instructions. Each macro instruction 
consists of the following types of arguments: 


e An I/O function code 


e Function-independent parameters, for example, I/O channel and 
event flag number 


e Function-dependent parameters Pl through P6 
VAX/VMS I/O function code names have the following format: 


I0$_function 


Many function codes have subfunction modifiers that can be associated 
with them. Subfunction modifier names have the following format: 


IOSM_subfunction 


The following are examples of VAX/VMS function codes and subfunction 
modifiers. 


IOS WRITELBLK 

IOS READPROMPT!IOSM NOFILTR 
TOS READVBLK =~ 

I0$_ DELETE! IO$M_DELETE 


When an RSX-11M image running under VAX/VMS issues a QUEUE I/O REQUEST 
directive, VAX/VMS determines the equivalent native function and 
executes a Queue I/O Request system service on behalf of the image. 
The I/O request is processed by the VAX/VMS I/0 system and the 
function is performed by a standard VAX/VMS device driver or ACP, 
Usually, RSX-11M I/O requests correspond to similar VAX/VMS requests. 
AS a result, the RSX-11M image is not aware of any differences in the 
I/O systems. However, if an image issues an I/O request that depends 
on characteristics of the RSX-11M I/O system that are not present’ in 
the VAX/VMS I/0 system, the requested I/O operation may not occur 
exactly as expected. In that event, the user should consult this 
chapter. 


Each RSX-11M T7O request consists of a function code, 
function-independent parameters, and function-dependent parameters. 
When VAX/VMS receives a QUEUE I/O REQUEST directive, it forms’ the 
equivalent VAX/VMS arguments for each RSX-11M parameter specified in 
the directive. Because VAX/VMS issues queue I/O requests using the 
VAX/VMS I/0 system, it must convert RSX-11M queue I/O requests to the 
native format for processing by the appropriate driver or ACP. 


I/O DRIVERS 


VAX/VMS handling of RSX-11M function-independent parameters, for 
example, efn, lun, and ast, is described in Chapters 2 and 3 and in 
the description of the QUEUE I/O REQUEST directive in Chapter 4. This 
chapter describes how VAX/VMS handles I/0 function codes and I/0 
function-dependent parameters. 


5.1 SUPPORTED DEVICES 


VAX/VMS Supports RSX-11M I/O functions for devices supported by both 
RSX-11M and VAX/VMS; that is, for disks, terminals, line printers, 
card readers, magnetic tapes, and the null device. The VAX/VMS_ I/O 
User's Guide lists the devices supported by VAX/VMS. 


If an RSX-11M image performs I/O to a device that VAX/VMS does not 
Support and that does not require special-case software, the I/O 
request is handled as if it specified a disk device. The I/O function 
code and parameters (Pl through P6) are handled just as they are for 
disk. No subfunction bits are used. 


5.2 GET LUN INFORMATION DIRECTIVE 


The GET LUN INFORMATION directive returns the same device-independent 
information under VAX/VMS as it does under RSX-11M Version 3.2. The 
format of the information returned for all devices is presented in the 
description of the GET LUN INFORMATION directive in Chapter 4. The 
VAX/VMS I/O User's Guide describes the format of the device-dependent 
information returned. 


5.3 STANDARD I/O FUNCTIONS 


The standard RSX-11M I/O functions -- attach, detach, and cancel I/O; 
read and write virtual block; and read and write logical block -- are 
supported for all devices in VAX/VMS. The sections that follow 
provide additional information about attach, detach, and cancel I/0. 


5.3.1 Attach and Detach I/O Device (IO.ATT and IO.DET) 


VAX/VMS categorizes devices as shareable and nonshareable. A 
shareable device, for example, a disk, can be accessed by many users 
without affecting the integrity of the data. Nonshareable devices, 
for example, terminals, allow access from only one process at a time. 
When an image assigns a channel to a nonshareable device, VAX/VMS 
implicitly allocates the device for exclusive use by the process. In 
the RSX-11M sense, the system attaches the device for the process. 
Because VAX/VMS' performs implicit allocation, images do not have to 
explicitly allocate and deallocate nonshareable devices during 
execution. 


If an image must have exclusive access to a _ shareable device, the 
device can be allocated in either of two ways: 


1. By an image issuing an Allocate Device system service 


2. By a user typing an ALLOCATE command to a command interpreter 
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Use of the ALLOCATE command has an advantage over use of the Allocate 
Device system service. It eliminates the need for error recovery by 
the image if the device is not available for allocation. Tasks 
running in RSX-11M frequently attach terminals and other devices to 
prevent another task from using them. These devices are shareable in 
an RSX-11M system. When an RSX-11M image running under VAX/VMS issues 
a QUEUE I/O REQUEST to attach a device, VAX/VMS performs no operation 
and returns a success status to the image. If the target device is 
nonshareable, VAX/VMS allocates the device when the image assigns a 
LUN to it. In effect, therefore, the device is attached. If the 
device is shareable, it remains unallocated after the directive status 
is returned. When an RSX-11M image requires allocation of a shareable 
device, the device must be allocated from a terminal or an _ indirect 
command file by using an ALLOCATE command. 


The RSX-11M function code IO.ATT and IO.DET have meaning for terminals 
under VAX/VMS, as described in Section 5.8, "Terminal Driver." For 
example, issuing an attach or detach request causeS a cancel CTRL/O 
function. 


5.3.2 Cancel I/O Requests (IO.KIL) 


When an RSX-11M image issues a kill I/O request for a VAX/VMS' device, 
VAX/VMS executes a Cancel I/O on Channel system service. This system 
service cancels all I/O issued from the designated channel. This 
differs from the RSX-11M approach in that RSX-11M causes all I/O from 
the issuing task to the device to be canceled, When a cancel _ I/0 
request is issued for a disk device, no operation is performed. 
VAX/VMS returns a success status to the image. 


When the Cancel I/O on Channel system service executes, it notifies 
the driver immediately. Queued I/O requests are canceled immediately; 
however, I/O that the driver is currently processing is not 
necesSarily canceled. 


5.4 I/O STATUS BLOCK AND STATUS RETURNS 


When VAX/VMS completes an I/O operation, it returns a code indicating 
the status of the request in an I/O status block. When an RSX-11M 
image issues a request, VAX/VMS returns status information in an I/O 
status block that has the standard RSX-11M format, as illustrated in 
Figure 5-l. 





Byte 1 Byte 0 
Word 0 0 is ERE IO! Status code 
terminal read 
Word 1 Number of bytes transferred 


Figure 5-1 Format of RSX-11M I/O Status Block under VAX/VMS 


The return code can be IS.SUC or any of the error status codes’ listed 
in Table 5-1. The status code IS.SUC corresponds to the VAX/VMS 
Status code SSS NORMAL. VAX/VMS equivalents for RSX-11M error codes 
also are provided in Table 5-1. The high-order byte of word 0 always 
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contains a zero except in the case of terminal I/O read requests. For 
a terminal read request, that byte indicates the line terminator, as 
described in Section 5.8.14. 







The second word of the I/O status block contains the number of bytes 
read or written. 
Table 5-1 
I/O Status Return Codes 
DSW Code VAX/VMS Code Meaning 
SS$_ABORT An I/O request was canceled before the 



























SS$_CANCEL 


IE.ALN 





SS$_FILALRACC 


IE.BAD 





SS$_BADFILENAME 


SS$_BADPARAM 





IE.BCC SS$_DATACHECK 





IE.BDR SS$_BADIRECTORY 


IE.BHD 





SS$_BADFILEHDR 


SS$_FILESTRUCT 





IE.BLK SS$_ILLBLKNUM 





IE.BVR SS$_BADFILEVER 


SS$_TOOMANYVER 





IE.CKS SS$_BADCHKSUM 





IE.CLO SS$_FILELOCKED 


operation was 
link was broken. 


completed, or a network 


An I/O request was canceled before’ the 
operation was completed. 
A DECnet logical link already existed 


or was pending. 


A filename contained illegal characters 
or was longer than nine characters. 
file 


A call to a network or ACP 


contained invalid parameters. 


A data check found a mismatch between 
disk data and memory data. 


A file specified as a directory either 
was not a directory or contained 
invalid data. 


A file header 
for example, 
consistent or 
free blocks, 


contained invalid data; 
the structure was not 
the storage map indicated 


The file structure on an accessed 
volume waS invalid for the called ACP. 
The logical block number specified for 
a file did not exist on disk. 

A file version number was greater’ than 
32727 % 

The maximum number of versions for a 
file already existed and all had 
greater version numbers than the 
specified version number. 

The checksum in a file header was 
invalid. 

A process attempted to access a_ locked 


file. 
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Table 5-1 (Cont.) 
I/O Status Return Codes 






IE.CNR SS$_ REJECT 






IE.DAA SS$_DEVALLOC 














IE.DAO 





SS$_BUFFEROVF 


SS$_DATAOVERUN 
SS$_MBTOOSML 


IE.DFU 





SS$_DEVICEFULL 


IE.DNA 





SS$_DEVNOTALLOC 
SS$_VOLINV 


IE.DNR SSS_DEVNOTMOUNT 






IE.DSQ SS$_EXDISKQUOTA 


















IE.DUN SS$_NOTFILEDEV 





IE.DUP SS$_DUPFILENAME 





IE.EOF SS$_ENDOFFILE 


SS$_BEGOFFILE 
SS$_ENDOFTAPE 


IE.EOV 





SS$_ENDOFVOLUME 





IE.EXP SS$_FILNOTEXP 


A request to connect to an object at a 
remote network node failed. 


An allocate request specified a device 
already allocated to another user. 


A buffer was not large enough for a 
string output by a system service; the 
string was truncated. 

A buffer was not large enough for data 
output by a system service. 

A mailbox was too small for data _ sent 
to: it. 

A device was full or did not have 
enough contiguous blocks to fill a 
request. 


A deallocate request specified a device 
that was not allocated. 

The volume-valid bit for a 
volume was not set. 


requested 


A dismount request specified a device 
that was not mounted. 


A process exceeded its disk quota. 


A file specification contained 
references to a directory or a file on 
a device that was not file-structured. 


A specified file already existed in the 
specified directory. 


The end of a file was’ reached. This 


was an EOF mark on a tape, an EOF card 
in a card reader, an empty mailbox, or 
the end of virtual memory. 

A backspace operation reached the 


beginning of a file. 


The end-of-tape mark was encountered on 


“a tape. 


The end of a volume was encountered. 

A file could not be written or deleted 
because it had not reached its 
expiration date. 


(continued on next page) 


DSW Code VAX/VMS Code 














IE.HFU 


IE.IES 


IE.IFC 


IE.LCK 


IE.NBK 


IE.NDR 


IE.NNL 


IE.NNN 


IE.NOD 
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Table 5-1 (Cont.) 


I/O Status Return Codes 


SS$_CRTLERR 
SS$_DRVERR 


SS$_UNSAFE 


SS$_HEADERFULL 


SS$_BADESCAPE 


SS$_ILLCNTRFUNC 
SS$_ILLIOFUNC 
SS$_ACCONFLICT 
SS$_DIRFULL 


SS$_NOLINKS 


SS$_FILNOTACC 


SS$_NOTNETDEV 
SS$_NOSUCHNODE 
SS$_ACPVAFUL 
SS$_EXQUOTA 
SS$_INSFMEM 


SS$_INSFWSL 


Meaning 


A hardware controller failed during an 
I/O operation. 


A device driver failed during an I/0 
operation. 


A device driver was unusable. 


A file header map was full and its 


extension was inhibited. 
A terminal escape sequence was invalid. 


The control function specified for an 
ACP was invalid. 


The function code specified for: an 
explicit I/O request was invalid. 

The access protection for a file did 
not allow a requested access. 


A file could not be created because the 
specified directory was full. 
link 


A logical network could not be 


created because no more slots were 
available. 
No file had been accessed on a_ channel 


that was 
operation, 


specified for an I/O 
A device specified for a network I/0 
operation was not a network device. 

A specified network node did not exist. 
A file ACP could not access a_ volume 
because it had no more virtual memory 


for volume service. 


A process attempted to exceed its limit 
or quota for a resource. 


More system dynamic memory was required 
than was available. : 


A process required more pages in its 
working set than it-was allowed. 
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Table 5-1 (Cont.) 
I/O Status Return Codes 


IE.NSF 





SS$_NOMOREFILES No more files matching a wildcard 
specification existed; at least one 


matching file was previously found. 






A specified file did not exist. 





SS$_NOSUCHFILE 


A device went offline. 





“IE.OFL SS$_DEVOFFLINE 






SS$_MEDOFL A requested device had no medium 
mounted on it (Such as a tape or a 


disk). 





A terminal escape sequence was 
truncated at the end of its buffer; 
the remainder of the sequence was 
written in the type-ahead buffer. 





IE.PES | SS$_PARTESCAPE 











IE.PRI SS$_NOPRIV A process requested initialization of a 
volume that it did not have the 


privilege to write. 






SS$_FCPREADERR An error occurred in reading file 


control data (such as a directory). 
SS$_FCPREWNDERR An error occurred in rewinding a 
volume. 






SS$_MBFULL A mailbox could. not accept another 


message because it was full. 


The control-C vector for a process was 
already in use by a controlling 
process, 






SS$_VECINUSE 






IE.SNC The index file for a volume contained 


invalid data. 





SS$_FILENUMCHK 






IE.SPC A process attempted to. access. memory 


outside its virtual address space. The 
PC contains the address of the invalid 
instruction. 






SS$_ACCVIO 


The file sequence number in a_ file 
header . was invalid; the directory 
entry pointed to an obsolete or deleted 
file. 


SS$_FILESEQCHK 






A network interrupt message contained 
more than.16 bytes of data. 


_IE.TMM 





SS$_TOOMUCHDATA 






SS$_ TIMEOUT 





_ITE.TMO An input operation was not completed 


within the specified timeout period. 






IE.VER SS$_PARITY A device-dependent error occurred. 
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Table 5-1 (Cont.) 
I/O Status Return Codes 


DSW Code 


IE.WAT | SS$_BADATTRIB 


























Meaning 














An invalid attribute was specified for 
a read or write using a file ACP. 
SS$_FCPSPACERR An I/O error occurred while a file 
control primitive was skipping spaces 
within or among files. 


An I/O error occurred while ae file 
control primitive was writing. 


SS$_FCPWRITERR 





IE .WLK SS$_WRITLCK The hardware write-lock switch was” set 


on a requested disk. 






IS.PND None An I/O request is pending. 


IS.SUC 





SS$_NORMAL An operation succeeded. 


5.5 DISK DRIVER 


Table 5-2 provides the correspondence between RSX-11M disk function 
codes and VAX/VMS disk function codes. 


Table 5-2 
Disk Function Code Correspondence 





Function RSX-11M Code 
















VAX/VMS Code or Action 
Attach Device No operation 
Detach Device No operation 
Cancel I/O Requests No operation 
Read Logical Block IO$_READLBLK 
Write Logical Block IO$_WRITELBLK 
Read Virtual Block IO0$_READVBLK 


Write Virtual Block IO$_WRITEVBLK 


Read Physical Block TOS_READPBLK 
Write Physical Block IO$_WRITEPBLK 


Write Physical Block 
(delete data mark) 


Not supported 


Load Overlay Special form of IO.RLB 
performed only on OV 
(overlay device); An 
IO.RVB is performed 

on LUNs not assigned 


to OV. 





Pack Acknowledge IO.STC 


I0$_PACKACK 
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Table 5-3 provides the correspondence of RSX-11M function-dependent 
parameters to VAX/VMS arguments. 


Table 5-3 
Disk Parameter Correspondence 


Parameter Function RSX-11M Pn | VAX/VMS Pn 


Starting buffer address Pl Pl 
(stadd) 


Buffer size (size) P2 P2 


High block number P4 P3 (high half of longword) 
(bk 1h) 


Low block number (blk1) P5 P3 (low half of longword) 





5.6 MAGNETIC TAPE DRIVER 
Table 5-4 provides the correspondence between RSX-11M magnetic’ tape 


function codes and VAX/VMS magnetic tape function codes. 


Table 5-4 
Magnetic Tape Function Code Correspondence 


RSX-11M Code | VAX/VMS Code or Action 


Attach Device IO.ATT No operation 
Detach Device IO.DET No operation 


Cancel I/O Requests IO.KIL Cancel I/O on Channel 
system service 


Read Logical Block IO.RLB IO$_READLBLK 
Write Logical Block IO.WLB IOS _WRITELBLK 
Read Virtual Block IO.RVB IO0$_READVBLK 
Write Virtual Block IO.WVB IO$_WRITEVBLK 
Write End-of-File Mark IO.EOF IO0$_WRITEOF 


Read Logical Block IO.RLV IOS _READPBLK! IOSM_ REVERSE 
Reverse 


Rewind Unit IO.RWD IOS_REWIND 


Rewind and Turn Unit IO.RWU IO$_REWINDOFF 
Off Line 
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Table 5-4 (Cont.) 
Magnetic Tape Function Code Correspondence 















Function RXS-11M Code VAX/VMS Code or Action 





Mount Tape and Set 
Characteristics 





IO$ SETMODE (only parity 
and density can be set) 


Sense Tape Character- 
istics 












I0$_SENSEMODE 


Space Blocks 





IO$_SPACERECORD 





Space Files IOS _SPACEFILE 


Set Tape Characteristics IOS SETMODE (only parity 


and density can be set) 





Table 5-5 provides the correspondence of RSX-11M_ function-dependent 


parameters to VAX/VMS arguments. 


Table 5-5 
Magnetic Tape Parameter Correspondence 
















Parameter Function RSX-11M Pn | VAX/VMS Pn 


Starting buffer address 


Pl 
(stadd) 
Buffer size (size) P2 
Characteristic bits (cb) Pl 


of IO.SMO and I0.STC 


Number of blocks to space 
past (nbs) of IO.SPB 


Pl 


Number of EOFs to space 
past (nes) of IO.SPF 


Pl 











5.7 LINE PRINTER DRIVER 


Table 5-6 provides the correspondence between RSX-11M line printer 
function codes and VAX/VMS function codes or resultant action. 
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Table 5-6 
Line Printer Function Code Correspondence 


RSX-11M Code | VAX/VMS Code or Action 


IO.ATT 








Function 









Attach Device No operation 












Detach Device IO.DET No operation 





IO.KIL 





Cancel I/O Requests Cancel I/O on Channel system 


service 









Write Logical Block 





IO.WLB I0$_WRITELBLK 









Write Virtual Block IO.WVB 





IOS _WRITEVBLK 









Write Physical Block 





I0.WPB 





IO$_WRITEPBLK 


Table 5-7 provides the correspondence of RSX-11M function-dependent 
parameters to VAX/VMS arguments. 


Table 5-7 
Line Printer Parameter Correspondence 


RSX-11M Pn VAX/VMS Pn 


Pl Pl 
P2 P2. 
P3 P4 


When using VAX/VMS line printers, keep in mind the following points; 








Parameter Function 








Starting buffer address 
(stadd) 


Buffer size (size) 


Vertical format control 
character (vfc) 


@e VAX/VMS line printers are not shareable. VAX/VMS implicitly 
allocates a line printer when a channel is assigned. 


e VAX/VMS line printers normally are spooled. A spooled printer 
is allocated to the print symbiont. VAX/VMS does not allow a 
process to allocate a spooled device unless it has_ the 
privilege to do so. An RSX-11M image is not allowed exclusive 
use of a spooled device (for example, printer) unless’ the 
‘process in which it is running has the necessary privilege and 
the ALLOCATE command has been issued to reserve the device 
prior to image execution. 


e If a printer is allocated or not spooled, the RSX-11M image's 
I0.WLB and I0O.WVB requests for it produce exactly the same 
results as in the RSX-11M operating system. 


uo 
t 


ll 
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e See Section 3.10, "“Spooled Devices," for a discussion of the 
requirements for issuing IO.WLB and IO.WVB’ requests to a 
spooled device. 


e If an RSX-11M image issues a GET LUN INFORMATION directive for 
a spooled device, the information returned is that for the 
intermediate device. 


5.8 TERMINAL DRIVER 


Table 5-8 provides the correspondence of RSX-11M function codes to 
VAX/VMS' functions. Table 5-9 provides the correspondence of the 
RSX-11M function-dependent parameters Pl through P6 to their VAX/VMS 
equivalents for terminal devices. Table 5-10 lists the subfunction 
bits applicable for each RSX-11M function code and _ provides’ notes 
describing VAX/VMS handling of these subfunctions for terminals. 


VAX/VMS places restrictions on the I/O functions that can be performed 
on TI, CO, and CL because they are mapped to process-permanent files, 
A places the same restrictions on I/O to user-created 
process-permanent files. Section 5.8.15, "Programming Hints," 
describes these restrictions. 


Table 5-8 
Terminal Function Code Correspondence 


Attach Device IO.ATT Terminal not attached; 
forces cancel CTRL/O 
on next write 


Detach Device IO.DET Terminal not. detached; 
forces cancel CTRL/O 
on next write 


Cancel I/O Requests IO.KIL Cancel I/O on Channel 
system service 


Read Logical Block IO.RLB IO$_READLBLK 
Write Logical Block IO.WLB IO$_WRITELBLK 
Read Virtual Block IO.RVB IO$_READVBLK 
Write Virtual Block IO.WVB IO$_WRITEVBLK 
Read Physical Block IO.RPB I0$_READPBLK 
Write Pass All IO0.WAL IO$_WRITEPBLK 


Read Logical Block IO.RPR IO$_READPROMPT 
after Prompt 


Get Multiple Characteristics SF.GMC Get I/O Channel Device 
Information system 
service 


Set Multiple Characteristics SF.SMC IOS_SETMODE 





Get Terminal Support I0.GTS Standard data returned 
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Table 5-9 
Terminal Parameter Correspondence 


Parameter Function RSX-11M Pn VAX/VMS Pn 


Starting buffer address 
(stadd) 


Buffer size (size) 


Vertical format control 
character (vfc) on write 


Timeout count (tmo) on 
read with prompt 


Prompt address (pradd) for 
read with prompt 


Prompt size (prsize) for 
read with prompt 


Vertical format control 
character (vfc) for read 
with prompt 





1. For all read functions except IO.RPB and IO.RST, the VAX/VMS P4 
parameter specifies RETURN, ESCAPE, and CTRL/Z as terminators. 
For IO.RPB, no characters are terminators. For IO.RST, P4 is 0 
specifying that all characters with a value less than an ASCII 
space are terminators except form feed, vertical tab, backspace, 
delete, and horizontal tab. 


NOTE 


The remaining device-specific function 
codes are the equivalent of the logical 
OR of a subfunction bit and one of the 
standard function codes IO.ATT, IO.RLB, 
or IO.WLB. See Table 5-10, "“Subfunction 
Bit Correspondence." 
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Table 5-10 
Subfunction Bit Correspondence 





APPLICABLE SUBFUNCTION BITS 


X = Corresponds directly to VAX/VMS function. 
n = Indicates correspondingly-numbered note. 


TF.AST|TF.BIN|TF.CCO|TF.ESQ|TF.RAL| TF.RNE| TF.RST| TF.WAL| TF.WBT} TF. XOF 















EQUIVALENT WITH 
FUNCTION | SUBFUNCTION BIT 


STANDARD FUNCTIONS: 



































m& |] Ww 


Hie 

Oo; 0 

a~1o 

H | & 

eid 
Lis 









IO.ATT! TF .AST 
(see Note 1) 


I0.WLBSTF.CCO 







SF.GMC 
I0O.GTS 
IO.RLB! TF. RAL 


I0.RAL 
(see Note 3) 


IO. RNE IO.RLB! TF .RNE 


i 
I0.RST IO.RLB!TF.RST 


IO.WLB: TF .WAL 


w 










IO.WLB! TF.WBT 
(See Note 2) 


2. Subfunction bit ignored for one of the following reasons. 
Function Reason 


TF.ESQ, TF.XON These are characteristics of the terminal line and cannot be 
controlled on a per-request basis. 


TF.WBT The write breakthrough function is not supported in VAX/VMS. 
See Section 5.8.8. 


TF.BIN Function is not supported in VAX/VMS. 
3. Sets the VAX/VMS function modifier IOS$M_NOFILTR. See Section 5.8.4.1. 
4. RSX-11M virtual functions do not accept these subfunction bits. 
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5.8.1 IO.ATT Function 


When an RSX-11M image uses the IO.ATT. function for a terminal, VAX/VMS 
performs no operation to alter the attached/detached status of the 
terminal, as described in Section 5.3.1. VAX/VMS does, however, issue 
a request to the terminal driver to cancel CTRL/O on the next 
operation to the terminal if that operation is a write. The VAX/VMS 
terminal driver subfunction modifier to cancel CTRL/O is 
IOSM CANCTRLO. The RSX-11M terminal driver also forces a cancel 
CTRL/O (TF.CCO) on a write operation that follows an attach operation. 


An IO.ATT function issued for TI, CO, or CL becomes a no-op. 


5.8.1.1 IO.ATT!ITF.AST and IO.ATA Functions - In VAX/VMS, an image can 
enable itself to receive an AST unsolicited characters and CTRL/Cs 
from the terminal. When the AST occurs, the image can respond to. the 
unsolicited character or CTRL/C. 


The ‘RSX-11M function codes IO.ATT!ITF.AST and IO.ATA are equivalent. 
When an RSX-11M image executing in VAX/VMS issues either of these 
codes, VAX/VMS issues a request to the terminal driver to enable = the 
image for an unsolicited character or CTRL/C AST, depending on the 
values of parameters Pl and P3, respectively. 


5.8.1.2 IO.ATT!ITF.ESQ Function - In VAX/VMS, certain features’ that 
are characteristic of a terminal line are set by issuing a set 
terminal mode request (IOS SETMODE) to the driver. Terminal 
characteristics cannot be altered for the duration of an I/O request 
by specifying a modifier to the request; nor can they be modified as 
a function of terminal allocation. The ability to recognize escape 
sequences on a terminal line is a characteristic of the terminal and 
must be set using IO$ SETMODE or a set command. 


In RSX-11M, the subfunction bit TF.ESOQ is used with either of the 
attach function codes (IO.ATT or IO.ATA) to indicate that the image 
recognizes any eScape sequences generated at the designated terminal. 
When VAX/VMS receives an I/O request containing the TF.ESQ subfunction 
from an RSX-11M image, it ignores that subfunction bit. The terminal 
characteristics remain unaltered. 


To enable for escape sequences, an RSX-11M image should issue ae set 
multiple characteristics request (SF.SMC). 


5.8.2 I0O.DET Function 


When an RSX-11M image uses the IO.DET function for a terminal, VAX/VMS 
performs no operation to alter the attached/detached status of the 
terminal, as described in Section 5.3.1. VAX/VMS does, however, issue 
a request to the terminal driver to cancel CTRL/O on the next 
operation to the terminal if that operation is a write. The VAX/VMS 
terminal driver subfunction modifier to cancel CTRL/O is 
IOSM CANCTRLO. The RSX-11M terminal driver also forces a_ cancel 
CTRL/O (TF.CCO) on a write operation that follows a detach operation. 


An IO.DET function issued for TI, CO, or CL becomes a no-op. 
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5.8.3 IO.KIL Function 


An IO.KIL function issued for TI, CO, or CL becomes a no-op. 


5.8.4 I0O.RLB, IO.RAL, IO.RNE, IO.RST, and IO.RTT Functions 


The function codes IO.RLB, IO.RAL, IO.RNE, and IO.RST all allow an 
image to read a logical block from a terminal. When VAX/VMS receives 
a read-logical-block request from an RSX-11M image, it issues an 
IO$_READLBLK request on behalf of the image. There is a direct 
correspondence between IO.RLB and IO$ READLBLK. The RSX-11M_ function 
codes IO.RAL, IO.RNE, and IO.RST are the equivalents of the logical OR 
of IO.RLB and a subfunction bit. The following sections describe 
VAX/VMS handling of subfunction bits used with read-logical-block 
requests. 


5.8.4.1 IO.RLB!ITF.RAL and IO.RAL - In VAX/VMS, the default terminal 
driver operation on a read request is to intercept and interpret 
control characters, for example, TAB, CTRL/R, CTRL/U, and DELETE. 
However, a native image has two options for restricting the 
interception of control characters by the driver. 


e It can specify the subfunction modifier IOSM NOFILTR on a read 
function (either IOS READLBLK, I0$ READVBLK, or 
IOS READPROMPT) to prevent the driver from intercepting 
CTRL/U, CTRL/R, or DELETE. 


e It can issue a read-physical-block (IOS READPBLK) request to 
prevent the driver from interpreting any characters. 


Normally, an RSX-11M image that issues a read-passing-all-data request 
actually wants to receive only a subset of the possible control 
characters; that is, it wants to receive CTRL/U, CTRL/R, and DELETE. 
As a result, when VAX/VMS receives an IO.RLB!ITF.RAL or IO.RAL request 
from an RSX-11M image, it issues a request specifying 
IO$_READLBLK!IOSM _NOFILTR on behalf of the image. 


The VAX/VMS equivalent of the RSX-11M read-passing-all-data function 
is read physical block (10S READPBLK). IOS READPBLK corresponds 
directly to the RSX-11M function code IO.RPB. I0.RPB has been added 
to the function codes that can be issued by an RSX-11M image to allow 
execution of the read-passing-all-data function under VAX/VMS. An 
RSX-11M image that a read-passing-all-data function under VAX/VMS must 
be modified to issue an IO.RPB. An image issuing I0O.RPB under. the 
RSX-11M operating system runs without receiving an error; that is, 
IO.RPB is a legal function. 


NOTE 


In RSX-11M, an IO.RPB request is 
equivalent to an IO.RLB request with a 
subfunction bit set. IO.RAL or I0.RPB 
work on both VAX/VMS and RSX-11M 
systems. 


VAX/VMS requires the image to have the appropriate privilege to read a 
physical block. 
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5.8.4.2 IO.RLB!ITF.RNE and IO.RNE Functions - The RSX-11M_= function 
codes IO.RLB!ITF.RNE and IO.RNE are equivalent. Either one corresponds 
directly to the VAX/VMS function code I0$ READLBLK or I0S READVBLK 
with a no echo function modifier (IOSM_NOECHO). 


5.8.4.3 IO.RLBITF.RST and IO.RST Functions - The RSX-11M_ function 
codes IO.RLB!ITF.RST and IO.RST are equivalent. Either one corresponds 
directly to the VAX/VMS function code IOS READLBLK with a _ function 
modifier of IO$SM TRMNOECHO and a record-termination parameter (P4) of 
0. IOSM TRMNOECHO prevents echoing of the line terminator. A_ record 
termination parameter of 0 causes all characters with a value less 
than an ASCII space to be terminators except form feed, vertical tab, 
backspace, and horizontal tab. 


5.8.4.4 IO.RLBITF.RTT and IO.RTT Functions - The RSX-11M function 
codes IO.RLB!TF.RTT and IO.RTT are equivalent. Either one corresponds 
directly to the VAX/VMS function code I0$ READVBLK with a = function 
modifier of IO$M_TRMNOECHO and a record-termination parameter P4. 


5.8.5 IO.RPR Function 


The IO.RPR function code corresponds directly to the VAX/VMS 
IO$_READPROMPT function code. However, the RSX-11M P6 parameter 
(vertical control character) is ignored. VAX/VMS handling of the 
subfunction bits TF.RAL, TF.RNE, and TF.RST with IO.RPR is exactly the 
same as it is for IO.RLB. VAX/VMS does not support use of the 
subfunction bit TF.BIN. VAX/VMS also ignores the subfunction bit 
TF.XOF if it is specified. 


If an IO.RPR./ function is issued for TI, CO, or CL and these devices 
correspond to process permanent files, the prompt is ignored. 


5.8.5.1 IO.RPRITF.XOF Function - In VAX/VMS, certain features’ that 
are characteristic of a terminal line are set by issuing a 
set-terminal-mode request (IOS SETMODE) to the driver. A  subfunction 
modifier indicates the characteristic to be changed. Terminal 
characteristics cannot be altered for the duration of an I/O request 
by specifying a modifier to the request; nor can they be modified as 
a function of terminal allocation. The ability to control XON/XOFF on 
a terminal line is a characteristic of the terminal and must be set 
using IOS SETMODE. 


In RSX-11M, the subfunction bit TF.XOF is used with IO.RPR to control 
XON/XOFF at the designated terminal. When VAX/VMS receives an I/0 
request containing the TF.XOF subfunction from an RSX-11M image, it 
ignores that subfunction bit. The terminal characteristics remain 
unaltered. 


To control XON/XOFF, an RSX-11M image should issue a set multiple 
characteristics request (SF.SMC). 
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5.8.6 IO.RVB Function 


The IO.RVB function code corresponds directly to the VAX/VMS 
IO$_READVBLK. No subfunction bits are supported in RSX-11M for 
IO.RVB. 


5.8.7 I0.RPB Function 


See the discussion of IO.RAL in Section 5.8.4.1. 


5.8.8 IO.WLB, I0.CCO, and IO.WBT Functions 


The function codes IO.WLB, I0.CCO, and IO.WBT all allow an image to 
write a logical block to ae terminal. When VAX/VMS-~ receives a 
write-logical-block request from an RSX-11M image, it issues an 
IO$_WRITELBLK request. There is a direct correspondence between 
IO.WLB and IOS WRITELBLK. The RSX-11M function codes I0.CCO, and 
IO.WBT are the equivalents of the logical OR of IO.WLB anda 
subfunction bit. The sections that follow describe VAX/VMS handling 
of subfunction bits on write-logical-block requests. 


5.8.8.1 IO.WLB!ITF.CCO and I0.CCO Functions - The RSX-11M_ function 
codes IO.WLB!TF.CCO and I0O.CCO are equivalent. Either one corresponds 
directly to the VAX/VMS IO$ WRITELBLK function with a_ function: 
modifier of IOSM_CANCTRLO. = 


5.8.8.2 IO.WLBIWBT and IO.WBT Functions - In VAX/VMS, the 
write-break-through function is implemented using the Broadcast system 
service. AS a result, neither of the RSX-11M~ function codes 
IO.WLB!WBT or IO.WBT corresponds directly to a VAX/VMS' driver 
function. When an RSX-11M image requests write-break-through, VAX/VMS 
issues a IO$ WRITELBLK function to the driver. A normal 
write-logical—block function occurs. 


5.8.9 IO.WVB Function 


The RSX-11M function code IO.WVB corresponds directly to the VAX/VMS 
function code IOS WRITEVBLK. VAX/VMS handles the subfunction bits 
allowed with IO.WVB in the same manner as it handles the subfunction 
bits for IO.WLB. The resulting I/O operation is a write virtual 
block, however. 


5.8.9.1 IO.WLBITF.WAL, IO.WAL, and IO.CCO!ITF.WAL Functions - The 
RSX-11M function codes IO.WLB!ITF.WAL and IO.WAL are equivalent. The 
RSX-11M function IO.CCO!TF.WAL adds the cancel CTRL/O subfunction to 
an IO.WAL request. When an RSX-11M image issues a write-all-data 
request, VAX/VMS issues an IOS WRITELBLK!IOSM NOFORMAT request’ to 
cause the data block to be transferred without interpretation to the 
specified buffer. 
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VAX/VMS requires an image to have the appropriate privilege to write a 


physical block. An RSX-11M image must have this privilege to 
successfully issue an IO.WAL request. 

5.8.10 IO.WPB Function 

The RSX-11M function code IO.WPB corresponds directly to the VAX/VMS 
function code I0$ WRITEPBLK. No subfunction bits are applicable. 
5.8.11 I10.GTS Function 

VAX/VMS has no system generation options that control the features 
included in the terminal driver. 

When an RSX-11M image issues an I10.GTS request, VAX/VMS returns a 
4-word buffer of information that describes the VAX/VMS terminal 


driver features. Because these 
information always is returned. 


features cannot be altered, the same 
Table 5-11 lists the terminal support 


information returned under VAX/VMS. 


That information includes all of 
under RSX-11M with the following 


Word 0, bit 1 F1.BTW 
bit 2 F1l.BUF 
bit 14 F1.UTP 
bit 15 F1.VBF 
Tab 
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input 
F1.HLD Hold scr 
F1.LWC Lower-to 
F1.RNE Read wit 
F1.RPR Read aft 
F1.RST Read wit 











the features that can be returned 
exceptions, which are always zero: 


Write-break-through 

Checkpointing during terminal input 
Input characters buffered in task's 
address space 

Variable-length terminal buffers 


le 5-11 
et Terminal Support (10.GTS) 


Meaning 


c CRLF on long lines 
ted-character-input AST 


TRL/O before writing 






e escape sequences’ in solicited 


een mode 

-uppercase conversion 
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Table 5-11 (Cont.) 
Information Returned by Get Terminal Support (I0.GTS) 


Meaning 


scan nttnt NAM as non abe 1 4 a ate eRe EE ELMORE amenimeneat 


F1.RUB CRT rubout 
F1.SYN CTRL/R terminal synchronization 


F1.TRW Read all and write all 


F2.SCH Set characteristics QUI (SF.SMC) 


F2.GCH Get characteristics QUI (SF.GMC) 


Not used in RSX-11M 


Not used in RSX-11M 





NOTE 


An I10.GTS function issued for TI, CO, or 
CL returns no information. 


5.8.12 SF.GMC Function 


When an RSX-11M image issues an SF.GMC request, VAX/VMS executes a Get 
I/O Channel Device Information system service and returns’ the 
appropriate information to the RSX-11M image in the standard format. 
Table 5-12 lists the terminal characteristics that can be returned for 
SF.GMC requests. The RSX-11M characteristic TC.PRI is never’ returned 
by VAX/VMS because VAX/VMS does not incorporate the concept of a 
privileged terminal. 


An SF.GMC function issued for TI, CO, or CL when the device 
corresponds to a process permanent file becomes a no-op. 


5.8.13 SF.SMC Function 


When an RSX-11M image issues an SF.SMC function, VAX/VMS issues an 
IOS SETMODE request. Table 5-12 provides the correspondence among 
RSX-11M terminal characteristics bit names and VAX/VMS~ subfunction 
modifiers used with the function code I0$ SETMODE. 


An RSX-11M image cannot set terminal type (TC.TTP) using a SF.SMC 
function. A DCL or MCR SET command can be used to set the terminal 
type. The TC.TBF characteristic for the SF.FMC request clears’ the 
type-ahead buffer. 


An SF.SMC function issued for TI, CO, or CL when the _ device 
corresponds to a process-permanent file becomes a no-op. 
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Table 5-12 
Terminal Characteristics for SF.GMC and SF.SMC Requests 


RSX-11M 
Bit Name VAX/VMS Code Meaning 


TC.ESQ TMSM_ ESCAPE Escape-sequence generation 


TC.HLD TMSM_HOLDSCREEN Hold screen mode 


TC.NEC TMSM_NOECHO No-echo mode 
TC.SCP TMSM_SCOPE Scope device 
TC. SLV TMSM_NOTYPAHEAD Slave device 
TC.SMR TMSM_LOWER Lowercase allowed 


TC.TBF -- Number of characters 
in type-ahead buffer 


TC.TTP Terminal type; see Terminal type 
the VAX-11/RSX-11M 
User's Guide 





5.8.14 Terminal Read Status Returns 


The contents of an I/O status block used for terminal requests is the 
same as that used for all QIO operations except for terminal read 
operations. For terminal read operations, the high-order byte of the 
first word contains a code that indicates the character or sequence 
that terminated the read operation. Any one of the _ following codes 
can be returned. 


Code Meaning 

IS.CR Read terminated by RETURN 

IS.ESC Read terminated by ALTMODE 

IS.ESQ Read terminated by an escape sequence 


-- Other terminator character 
0 Read terminated by full buffer 


When uSing VAX/VMS terminal function codes and parameters, keep in 
mind the following points: 


e VAX/VMS terminals can be spooled. 


e See Section 3.10, "Spooled Devices," for a discussion of the 
requirements for issuing IO.WLB and I0O.WVB- requests to a 
spooled device. 


e If an RSX-11M image issues a GET LUN INFORMATION directive for 
a spooled device, the information returned is for the 
intermediate device, that is, for a disk. 
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e TI, CO, and CL map to VAX/VMS' proceSS-permanent files as 


follows: 

RSX-11M Pseudo-Device VAX/VMS Process-~-Permanent Files 
TI SYSSINPUT and SYSSOUTPUT 
co SYSSCOMMAND 
CL SYSSERROR 


@e Process-permanent files are controlled using VAX~-11l RMS unless 
they map to terminals. VAX/VMS, therefore, limits the I/0 
function codes that can be used to access these files to read 
and write functions only. All subfunction bits are ignored. 
Functions other than read and write are illegal and result in 
the I/O status code IE.IFC (illegal function for this device) 
being returned. 


e For RSX-11M images, user-created process-permanent files 
appear as record-oriented terminal devices. 


e When process-permanent files map to terminals, queue I/0 
requests can be issued. 


e The device characteristics for TI, CO, and CL are as follows: 


~- unit record device 
-~- terminal 

-- 132-byte buffer 

-- carriage control 
-- no lowercase 


5.9 CARD READER DRIVER 


Table 5-13 provides the correspondence between RSX-11M card reader 
functions and VAX/VMS function codes or resultant actions. 


Table 5-13 
Card Reader Function Code Correspondence 




















Function RSX-11M Code VAX/VMS Code or Action 

aveeer Device IO.ATT No operation 

Detach Device IO.DET No operation 

Cancel I/O Request IO.KIL Cancel I/O on Channel system 

service 

Read Virtual Block IO.RVB IO$_READVBLK 

Read Logical Block IO.RLB IO$_READLBLK 

Read Logical Block IO.RBD 


IO$_READLBLK!IOSM_BINARY 








The two function-dependent parameters (Pl and P2) for RSX-11M card 
reader functions correspond directly to Pl and P2 of VAX/VMS card 
reader functions. 
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5.10 NULL DEVICE 


VAX/VMS supports the use of a null device by RSX-11M images. As under 
RSX-11M, a read request to the null device results in an end-of-file 
Status return (IE.EOF), and a write request results in success” status 
return (IE.SUC). 


I/O to the null device is treated like I/O to an unsupported device as 
described in Section 5.1, "Supported Devices." 


5.11 DISK AND MAGNETIC TAPE ACPs 


I/O operations involving file-structured devices (disk and magnetic 
tape) often require ACP intervention. Normally, RSX-11M images 
perform I/O using RMS-11 or FCS; they do not issue QUEUE I/O REQUEST 
directives directly to an ACP. Any ACP intervention needed is 
requested by RMS-11l1 or FCS and occurs transparently from the image's 
point of view. It is possible, however, for images to request ACP 
functions directly by issuing a QUEUE I/0 REQUEST directive and 
specifying an ACP function code. 


The information in this section is relevant only to RSX-11M images 
that issue ACP functions directly, for example, create file and enter 
file name. Other RSX-11M images running under VAX/VMS can rely. on 
RMS-l1l1 or FCS to request appropriate RSX-11M ACP functions during 
image execution. 


VAX/VMS ACP functions are expressed using six function codes and three 
function modifiers. The six function codes follow. 


e IOS CREATE -- Create file 
@ 10S ACCESS -- Access file 
@ I0$ _DEACCESS -- Deaccess file 
@ 10S MODIFY -- Modify file 
@ 10S DELETE -- Delete file 
e IOS _ACPCONTROL -- ACP control 


The three function modifiers, which can be applied to the create, 
access, and delete functions, follow. 


@ IOSM_ACCESS -- Open file on user's channel 
e IOSM_CREATE -- Create a file identification 
e IOSM_DELETE -- Delete file 


By uSing a function code and a function modifier together, an image 
can request multiple ACP operations in one I/O request. For example, 
IOS CREATE!IOSM ACCESS requests the ACP to create a file and to access 
the file on the specified channel. IOS DELETE!IOSM DELETE causes a 
file's directory entry and file header to be deleted; that is, the 
file is deleted. IOS DELETE with no function modifier causes the 
file's directory entry to be deleted. 
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In addition to function codes and modifiers, VAX/VMS ACPs use 
identification block (FIB) for communication between the requester and 
The function-dependent parameter Pl for all ACP requests is 
the address of a descriptor for the associated FIB. The FIB 
much of the information passed to an ACP by an RSX-11M image 


the ACP. 


through 





RSX-11M ACP functions 


codes: 
e 


P6. 


a file 


contains 
in Pl 


Figure 5-2 illustrates a FIB. The VAX/VMS I/O User's 
Guide provides a detailed description of the contents of a 
describes the ACP functions supported by VAX/VMS,. 
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e IO.RAT -- Read attributes 
e I0O.DAC -- Deaccess file 

e I0.DEL -- Delete file 

e I0O.FNA -- Find file name 

e I0.RNA -~ Remove file name 
e IO.ENA -- Enter file name 
e I0O.APC -- ACP control 


When an RSX-11M image issues an ACP request under VAX/VMS, VAX/VMS 
issues a Queue I/O Request system service to the ACP. It obtains the 
data to fill in the FIB and function-dependent parameters for _ the 
request from two Sources: 


e Function-dependent parameters supplied by the image in the 
QUEUE I/O REQUEST directive 


e Data structures pointed to by function-dependent parameters, 
for example, the file name block 


Once the requested function is performed, VAX/VMS fills in the RSX-11M 


image's data structures with the same information that is returned to 
the image when executing under the RSX-11M operating system. 


5.11.1 General Correspondence of Parameters 
Table 5-14 identifies the relationship of RSX-11M function-dependent 
parameters to VAX/VMS function-dependent parameters and FIB fields. 


Table 5-14 
ACP Parameter Correspondence 


Parameter Function VAX/VMS Equivalent 


File identification FIBSW_FID (value) 
pointer 

















RSX-11M Pn 












Pl (pointer) 


Attribute list pointer P2 P5 (reformatted) 


Extend control P3 (high byte) FIBSW_EXCTL 











FIBSL EXVBN~ for 
truncate only; 
FIBSL EXSZ for 
extend 


Delta size in blocks P3 (low byte) and P4 


Window size P5 (low byte) FIBSB WSIZE 


Access control P5 (high byte) FIBSL_ACCTL 


File name block pointer P2 (name string) 
and P4 (result 
string) 


5.11.2 
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IO.CRE Function 


Equivalent Function Code: IO$ CREATE!IOSM CREATE 


Notes: 


Sedb.3 


If the extend size is supplied in the low-order byte of P3 and 
in P4, it is stored in FIBSL_EXSZ. 


The high-order byte of P3 (extend control) is used to set bits 
in FIBSW_EXCTL: 


FIBSV_EXTEND = EX.ENA 
FIBSV_ALCON = EX.AC1 
FIBSV_ALCONB = EX.AC2 
FIBSV_FILCON = EX.FCO 
FIBSV_ALDEF = EX.ADF 


The file identification is copied from FIBSW FID and returned 
in the address pointed to by Pl (FID pointer). 


Information in the VAX/VMS attribute list is derived from the 
RSX-11M attribute list, if one is supplied. 


The extend size in blocks is returned in bytes 1, 2, and 3 of 
the I/O status block. 


IO.DEL with EX.ENA=0 


Equivalent Function Code: I0$ DELETE!IO$M_DELETE 


Note: 


5.11.4 


The file identification pointed to by Pl is copied into 
FIBSW_FID. 


IO.DEL with EX.ENA=1 


Equivalent Function Code: 10$ MODIFY 


Notes: 


The file identification pointed to by Pl is copied into 
FIBSW FID. 


FIBSV_TRUNC is set in field FIB$W_EXCTL. 


The extend size supplied in the low byte of P3 and in P4 is 
incremented by 1 and stored in FIBSL_EXVBN. 


The file round-up in blocks is returned in bytes 2 and 3 of 
the I/O status block. File round-up is the number of blocks 
added to the specified file size to reach the next’ cluster 
boundary. 
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5.11.5 I0O.ACR Function 
Equivalent Function Code: I0$ ACCESS!IO$M_ACCESS 
Notes: 


e The file identification pointed to by Pl is copied _ into 
FIBSW_FID. 


e The high-order byte of P5 (access control) is used to set bits 
in FIBSL_ACCTL: 


FIBSV NOWRITE = AC.LCK 
FIBSV_REWIND = AC.RWD 
FIBSV_CURPOS = AC.POS 
FIBSV_UPDATE = AC.UPD 


e The window size provided by the low-order byte of P5 is stored 
in FIBSB_WSIZE. 


e Information in the VAX/VMS attribute list is derived from the 
RSX-11M attribute list, if one is supplied. 


5.11.6 I0.ACW and IO.ACE Functions 
Equivalent Function Code: IO$_ACCESS!IOSM_ACCESS 


Notes: 


e The file identification pointed to by Pl is copied into 
FIBSW_FID. 


e The high-order byte of P5 (access control) is used to set bits 
in FIBSL_ACCTL: 


FIBSV_DLOCK = AC.DLK 
FIBSV_NOWRITE = AC.LCK 
FIBSV_REWIND = AC.RWD 
FIBSV_CURPOS = AC.POS 
FIBSV_UPDATE = AC.UPD 


In addition, VAX/VMS sets FIBSV_WRITE. 


e The window size provided by the low-order byte of P5 is stored 
in FIBSB_WSIZE. 


e Information in the VAX/VMS attribute list is derived from the 
RSX-11M attribute list, if one is supplied. 


5.11.7 I0O.DAC Function 
Equivalent Function Code: IOS DEACCESS 
Notes: 


e The file identification pointed to by Pl is copied into 
FIBSW_FID. 


e Information in the VAX/VMS attribute list is derived from’ the 
RSX-11M attribute list, if one is supplied. 


2o2) 


I/O DRIVERS 


5.11.8 IO.EXT Function 
Equivalent Function Code: I0$ MODIFY 


Notes: 


e The file identification pointed to by Pl is copied into 
FIBSW FID. 


e The high-order byte of P3 (extend control) is used to set bits 
in FIBSW_EXCTL: 


FIBSV_EXTEND = EX.ENA 
FIBSV_ALCON = EX.AC1 
FIBSV_ALCONB = EX.AC2 
FIBSV_FILCON = EX.FCO 
FIBSV_ALDEF = EX.ADF 


e The extend size supplied in the low-order byte of P3 and in P4 
is stored in FIBSL_EXSZ. 


e The amount by which the file is extended is returned in bytes 
1, 2, and 3 of the I/O status block. 


5.11.9 IO.WAT Function 
Equivalent Function Code: I0$ MODIFY 
Notes: 


e The file identification pointed to by Pl is copied into 
FIBSW_FID. 


e Information in the VAX/VMS attribute list is derived from the 
RSX-11M attribute list, if one is supplied. 


5.11.10 IO.RAT Function 
Equivalent Function Code: IOS ACCESS 


Notes: 


e The file identification pointed to by Pl is copied into 
FIBSW_FID. 


e Information in the VAX/VMS attribute list is derived from the 
RSX-11M attribute list, if one is supplied. 


5.11.11 I0.FNA Function 
Equivalent Function Code: I0$ ACCESS 


Notes: 


e The file identification is copied from FIBSW_FID and returned 
in the address pointed to by Pl. 


e The directory identification is copied from the file name 
block into FIBS$W DID. 


5.11.12 
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The file name string supplied in the request is constructed 
from the Radix-50 file name in the file name block. 


If the bit NB.WLV is set in N.STAT of the file name block, a 
resultant string is constructed from the Radix-50 name and 
type. The version number is stored in N.FID+4 of the name 
block, and is supplied as input to the IO$_ ACCESS call. 


If NB.WLV is not set, a resultant string of zero length is 
supplied. 


The file name string returned is the resultant string returned 
by the Queue I/O Request system service. It is converted back 
to Radix-50 and returned to the file name block. 


Control bits in field N.STAT of the file name block are _ used 
to set bits of FIBSW_NMCTL: 


FIBSV_ALLNAM = NB.SNM 
FIBSV_ALLTYP = NB.STP 
FIBSV ALLVER = NB.SVR 


FIBSV_WILD NB.SNM!NB.STP!NB.SVR 


The file name block field N.NEXT is used to set FIBSL WCC. 
The resulting value of FIBSL_WCC is returned in N.NEXT. 


IO.RNA Function 


Equivalent Function Code: I0$ DELETE 


Notes: 


The file identification is copied from FIBSW_FID and returned 
in the address pointed to by Pl. 


The directory identification is copied from the file name 
block into FIBSW_DID. 


If the bit NB.WLV is set in N.STAT of the file name block, a 
resultant string is constructed from the Radix-50 name and 
type. The version number is stored in N.FID+4 of the name 
block, and is supplied as input to the IOS ACCESS call. 


If NB.WLV is not set, a resultant string of zero length is 
supplied. 


The file name string supplied in the request is constructed 
from the Radix-50 file name in the file name block. 


The file name returned is the resultant string returned by the 
Queue I/O Request system service. It is converted back to 
Radix-50 and returned to the file name block. 


Control bits in field N.STAT of the file name block are used 
to set bits of FIBSW_NMCTL: 


FIBSV_ALLNAM = NB.SNM 
FIBSV_ALLTYP = NB.STP 
FIBSV_ALLVER NB.SVR 


FIBSV_WILD NB.SNM!NB.STP!INB.SVR 


The file name block field N.NEXT is used to set FIBSL_WCC. 
The resulting value of FIB$L WCC is returned in N.NEXT. 


5=29 
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IO.ENA Function 


Equivalent Function Code: I0$ CREATE 


Notes: 


5.11.14 


The file identification is copied from the file name block 
into FIBSW_FID. 


The directory identification is copied from the file name 
block into FIBSW_DID. 


The file name string supplied in the request is constructed 
from the Radix-50 file name in the file name block. 


The file name returned is the resultant string returned by the 


Queue I/O Request system service. It is converted back to 
Radix-50 and returned to the file name block. 


IO.APC Function 


Equivalent Function Code: IOS ACPCONTROL 


Notes: 


P3 contains the subfunction identification. The low-order 
byte of P3 is zero-extended and stored at FIBSW CNTRLFUNC, 
which overlays FIBSW EXCTL. The RSX-11M ACP subfunction codes 
have direct equivalents in VAX/VMS, as follows. 


RSX-11M Subfunction VAX/VMS Subfunction 


FF.NV FIBSC NEXTVOL 
FF.POE FIBSC POSEND 

FF .RWD FIBSC REWINDVOL 
FF.RWF FIBSC REWINDFIL 
FF.SPC FIBSC_SPACE 


For the FF.SPC subfunction, P4 is sign-extended and stored at 
FIBSL CNTRLVAL, which overlays FIBSL EXSZ. A negative value 
for P4 specifies the number of blocks to space _ backward. A 
positive value indicates the number of blocks to_ space 
forward. 
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VAX-11 COMPATIBILITY MODE INSTRUCTION SET 


Table A-1 lists the VAX-11 compatibility mode instruction set. 


Table A-1l 
VAX-11 Compatibility Mode Instruction Set 


Opcode Mnemonic 
(octal) 

000002 RTI 

000006 RTT 

0001DD JMP 

00020R RTS 
000240-000277 Condition codes 
0003DD SWAB 
000400-003777 Branches 
100000-103777 Branches 

OO4RDD JSR 

-950DD CLR(B) 

-051DD COM (B) 

-052DD INC (B) 

~053DD DEC (B) 

-054DD NEG (B) 

~055DD ADC (B) 

~056DD SBC (B) 

-057DD TST (B) 

-060DD RCR(B) 

-061DD ROL (B) 

-062DD ASR (B) 

-063DD ASL (B) 

0065SS MFPI (See note below.) 
0066DD MTPI (See note below.) 
1065SS MFPD (See note below.) 
10646DD MTPD (See note below.) 
0067DD SXT 

070RSS MUL 

071RSS DIV 

072RSS ASH 

073RSS ASHC 

074RSS XOR 

077RNN SOB 

-LSSDD MOV (B) 

-2SSDN CMP (B) 

- 3SSDD BIT(B) 

~4SSDD BIC (B) 

-5SSDD BIS(B) 

O6SSDD ADD 

16SSDD SUB 


VAX-11 COMPATIBILITY MODE INSTRUCTION SET 


NOTE 


The MFPI, MTPI, MFPD, and MTPD, 
instructions execute exactly as they 
would on a PDP-11l in user mode _ with 
Instruction and Data space overmapped. 
More specifically, they ignore the 
previous access level and act like PUSH 
and POP instructions referring to the 
current stack. 


VAX/VMS provides emulation of the FPP floating-point instructions. 
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PARSE DIRECTIVE 


The parse directive allows an RSX-11M image to use VAX/VMS file 
specifications that are not fully qualified because of the use of 
logical names. Use of this directive replaces the operation of the 
FCS .PARSE, .PRSDR, and .PRSDV routines and the RMS-11 SPARSE routine 
for RSX-11M images running in VAX/VMS. 


An RSX-11M image requests the parsing of a file specification by 
issuing a parse directive that supplies the addresses of a file name 
block and data structures containing default information. VAX/VMS 
uses the information supplied by the image and information contained 
in the RSX-11M logical name table and the system logical name table to 
build the primary and default strings that VAX-11 RMS requires to 
perform the actual parsing. VAX-11 RMS returns the expanded name to 
VAX/VMS. VAX/VMS, in turn, uses the expanded name to fill in the 
appropriate RSX-11M data structures, for example, returned directory 
string and file name block. The result is that the image receives the 
information in the normal RSX-11M formats. 


The image can request four different types of parsing: 
e Parsing of the full file specification (normal mode) 
e Parsing of the device name only (device-only mode) 


e Parsing of the file name using the default file name block as 
the major source of input (dfnb mode) 


e RMS-11 mode of parsing 


B.1 NORMAL MODE PARSING 
When the mode parameter is equal to 0, VAX-11 RMS parses the full file 
specification. VAX/VMS builds the primary string required as input to 
VAX-11 RMS by concatenating fields of the dataset descriptor, as 
follows: 

e Device 


e Directory 


e Filename.type;version 


PARSE DIRECTIVE 
It builds the default string from fields of the default file name 
block and from the default directory descriptor, as follows: 
e Device from the LUN or default file name block 


e Default directory from the image's default directory 
descriptor 


e Filename.type;version from the default file name block 


VAX-11 RMS returns to the RSX-11M image a filled-in file name _ block 
and directory string descriptor in the file name block. The directory 
string is returned at the address specified in the descriptor. 


B.2 DEVICE-ONLY PARSING 


When the mode parameter is equal to 1, VAX-11 RMS parses only the 
device and directory portion of the file specification. It uses the 
same sources for the primary and default strings as it does for a 
normal parsing operation. 


B.3 DEFAULT FILENAME BLOCK PARSING 


When the mode parameter is equal to 2, VAX/VMS uses the Radix-50 file 
name in the default file name block to build the ASCII file name for 
the primary string. 


For the default string, VAX/VMS takes the device name from the default 
file name block. It takes the directory name from the default 
directory descriptor, and the file name, type, and version from _ the 
default file name block. 


The DSW return codes for default file name block parsing are the’ same 
as for normal mode parsing. 


B.4 RMS-11 PARSING 
When the mode parameter is equal to 3, VAX-11 RMS parses the _ file 
specification using the same method used by RMS-11. The format for 


the DPB is slightly different from that used for modes 0, 1, and 2, as 
described below. 


B.5 DIRECTIVE CALL AND DPB FORMATS 
The parse directive is called using DIRS, as follows: 


DIRS #pardpb 


PARSE DIRECTIVE 


The DPB has the following format for modes 0, 1, and 2. 


pardpb: ~-BYTE 145.,7 
eWORD mode 


eWORD lun 
eWORD dspt 
-WORD dfnb 
eWORD dfdd 
eWORD- fnb 


eWORD- rtdd 

mode = 0 for normal, 1 for device-only, 2 for default file 
name block, or 3 for RMS-ll. See the sections that 
follow for a description. 

lun = logical unit number. 

dspt = address of the data set descriptor. 


dfnb = address of the default name block. 


dfdd = address of the descriptor for the default directory 
string. See the first note below. 


fnb = address of the file name block. 


rtdd = address of the descriptor for the returned directory 
string. See the first note below. 


The DPB has the following format for mode 3. 


pardpb: -BYTE 145.,7 
~WORD mode 
»WORD lun 
»WORD pript 
»WORD did 
«WORD 0 (not used) 
~WORD fnb 
-WORD expnam 


The definitions of mode, lun, and fnb are the Same aS those for the 
DPB format provided above. 


pript = address of the primary input descriptor. 
did = address of the default input descriptor. 


expnam = address of the descriptor for the block in which 
to return the expanded name. 


DSW Return Codes: 


IS.SUC -- Success 

IE.BAD -- Invalid mode missing or bad parameter (default error) 
IE.NSF -- Directory not found (RMSS DNF) 

IE.BDI -- Bad directory syntax (RMSS DIR) 

IE.BNM -- Bad file name (RMSS (SYN,FNM,LNE,TYP,VER) ) 

IE.DNR -- Device not ready (RMS$ DNR) 

IE.DUN -- Device not available (RMSS CHN) 

IE.NSF -- File not found (RMS$_FNF) 

IE.BDV -- Bad device specification (RMS$_ DEV) 


Notes: 


PARSE DIRECTIVE 


All descriptor input parameters must be a 2-word block with 
the following format. 


~WORD size 
~WORD address 


RSX-11M does not support the parse directive. An RSX~-11M 
image using this directive can test for an illegal directive 
DSW code to determine whether it is executing under RSX-11M or 
VAX/VMS and take appropriate action at run time. 


INDEX 


A 


Abnormal termination, 2-10 
ABORT TASK directive, 4-8 
ABRTS macro, 4-8 

Account, 2-2 


ACP 
control, 5-23 
disk, 5-23 
Files-1ll, 3-11 
I/O, 3-4 


magnetic tape, 5-23 

ALLOCATE command, 5-3 

Allocate Device system service, 
3-4, 5-2 

ALTER PRIORITY directive, 4-9 

ALTPS macro, 4-9 

ALUNS macro, 4-10 

Assign device, 3-6, 4-10 

Assign I/O Channel system service, 
3-3, 4-10 

ASSIGN LUN directive, 3-6, 

Associate Common Event Flag 


4-10 


Cluster system service, 4-14 
AST 
declare, 4-33, 4-35, 4-37 
delivery, 2-9 
floating-point, 4-50 
power recovery, 4-52 
receive data, 4-54 
recognition 
disable, 4-17 
enable, 4-20 
service routine 
termination, 4-11 
termination, 4-53 
AST SERVICE EXIT directive, 4-11 


ASTXSS macro, 4-11 

ATRGS macro, 4-2 

Attach device, 3-4, 5-2 
ATTACH REGION directive, 4-2 


Block locking, 3-6 


C 


Cancel I/O on Channel system 
service, 5-3 

Cancel I/O Request system service, 
3-4 

CANCEL MARK TIME REQUESTS 
directive, 4-13 

CANCEL TIME BASED INITIATION 
REQUESTS directive, 4-15 


Cancel Timer Request system 


Service, 4-13 
Cancel Wakeup system service, 
4-15 


Card reader driver, 5-22 
Channel, I/O assign, 3-3, 4-10 
Characteristics, device, 3-4 
Checkpointing, 2-6 

disable, 4-18 

enable, 4-21 
CINTS macro, 4-2 
CL device, 3-8 
CLEAR EVENT FLAG directive, 4-12 
Clear Event Flag system service, 


4-12 
CLEFS$ macro 4-12 
Clock, system, 2-8, 4-31 


CMKTS macro, 4-13 
CNCTS macro, 4-2 
CO device, 3-8 
Code 
DSW, 2-5, 4-7 
I/O status, 5-3 
system status, 4-7, 4-24 
termination, 2-10 
Command line, MCR, 
Common areas, 2-9 
Common event flags, 2-4 
COMMON option, 2-9 
Compatibility 
FCS, 3-6 
instruction set, A-l 
mode, 1-l 
* PDP-11, 1-2 
RMS-11, 3-6 
RSX-11M, 1-3 
CONNECT directive, 4-2 
CONNECT TO INTERRUPT VECTOR 
directive, 4-2 
Control region, 1-5 
Conversion 
event flag, 2-4 
I/O code, 5-3 
I/O device, 3-8 
physical device, 3-7 
CRAWS macro, 4-2 
CREATE ADDRESS WINDOW directive, 
4-2 
CREATE GROUP GLOBAL EVENT FLAGS 
directive, 4-14 
Create Mailbox and Assign I/0 
Channel system service, 3-3 
CREATE REGION directive, 4-2 
CRGFS macro, 4-14 
CRRGS$ macro, 4-2 
CSROS macro, 4-15 


4-28 


Index-l 


INDEX 


D 


Debugging, SST vector table for, 
4-59 
DECLSS macro, 4-16 
DECLARE SIGNIFICANT EVENT 
directive, 2-7, 4-16 
Detach device, 5-2 
DETACH REGION directive, 4-3 
Detached process, 4-53 
Device 
assign, 3-6, 4-10 
attach, 3-4, 5-2 
buffer size, information, 4-26 
cancel I/O to, 5-3 
card reader, 5-22 
characteristics, 3-4, 4-26 
CL, 3-8 
CO, 3-8 
detach, 5-2 
disk, 5-8 
file-structured, 5-23 
information, 4-26, 5-2 
LB, 3-8 
line printer, 5-10 
logical name, 3-7, 4-10 
magnetic tape, 5-9 
mapping, 3-7 
name, 3-4, 3-6 to 3-7, 4-10 
nonshareable, 3-4, 5-3 
null, 5-23 
OV, 3-8 
physical, 4-10 
queue, 4-35, 4-37 
shareable, 3-4, 5-3 
SP, 3-8 
spooled, 3-1ll . 
supported, 5-2 
SY, 3-8 
SYSSCOMMAND, 3-8 
SYSSDISK, 3-8 
SYSSERROR, 3-8 
SYSSINPUT, 3-8 
SYSSLIBRARY, 2-9 
SYSSOUTPUT, 3-8 
terminal, 5-12 
TI, 3-8 
unit number, 3-4 
WK, 3-8 
DIRS macro, B-l 
Directive 
ABORT TASK, 4-8 
ALTER PRIORITY, 4-9 
ASSIGN LUN, 3-6, 4-10 
AST SERVICE EXIT, 4-11 
ATTACH REGION, 4-2 
CANCEL MARK TIME REQUESTS, 4-13 
CANCEL TIME BASED INITIATION 
REQUESTS, 4-15 
CLEAR EVENT FLAG, 4-12 
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compatibility, 1-3 

CONNECT, 4-2 

CONNECT TO INTERRUPT VECTOR, 4-2 

CREATE ADDRESS WINDOW, 4-2 

CREATE GROUP GLOBAL EVENT FLAGS, 
4-14 

CREATE REGION, 4-2 

DECLARE SIGNIFICANT EVENT, 2-7, 
4-16 

descriptions, 4-1 

DETACH REGION, 4-3 

DISABLE AST RECOGNITION, 4-17 

DISABLE CHECKPOINTING, 2-6, 4-18 

ELIMINATE ADDRESS WINDOW, 4-3 

ELIMINATE GROUP GLOBAL EVENT 
FLAGS, 4-19 

emulation, 1-3 

ENABLE AST RECOGNITION, 4-20 

ENABLE CHECKPOINTING, 2-6, 
4-21 

EXIT IF, 4-22 

EXIT WITH STATUS, 4-24 

EXTEND TASK, 4-25 

GET LUN INFORMATION, 3-4, 
4-26, 5-2 

GET MAPPING CONTEXT, 4-3 

GET MCR COMMAND FILE, 4-28 

GET PARTITION PARAMETERS, 2-6, 
4-30 

GET REGION PARAMETERS, 4-4 

GET SENSE SWITCHES, 4-4 

GET TASK PARAMETERS, 4-32 

GET TIME PARAMETERS, 2-8, 4-31 

handling, 4-1 

INHIBIT AST RECOGNITION, 4-17 

invalid, 4-1 

MAP ADDRESS WINDOW, 4-4 

MARK TIME, 2-8, 4-33 

PLAS, 1-4 

QUEUE I/O REQUEST, 4-35 

QUEUE I/O. REQUEST AND WAIT, 4-37 

READ ALL EVENT FLAGS, 4-42 

READ EXTENDED EVENT FLAGS, 4-43 

RECEIVE BY REFERENCE, 4-5 

RECEIVE DATA, 3-9, 4-40 

RECEIVE DATA OR EXIT, 3-9, 4-41 

RECEIVE DATA OR STOP, 4-38 

REQUEST TASK, 4-44 

RESUME TASK, 2-9, 4-45 

RUN TASK, 2-8, 4-46 

SEND BY REFERENCE, 4-6 

SEND DATA, 3-9, 3-11, 4-48 

SET EVENT FLAG, 4-49 

SPAWN, 4-53 

SPECIFY FLOATING-POINT PROCESSOR 
EXCEPTION AST, 4-50 

SPECIFY POWER RECOVERY AST, 4-52 

SPECIFY RECEIVE-BY-REFERENCE 
AST, 4-6 


INDEX 


Directive (Cont.) 

SPECIFY RECEIVE DATA AST, 4-54 
SPECIFY SST VECTOR TABLE FOR 
DEBUGGING AID, 4-59 
SPECIFY SST VECTOR TABLE FOR 

TASK, 4-60 
STOP, 4-57 
STOP FOR LOGICAL OR OF EVENT 
FLAGS, 4-56 
STOP FOR SINGLE EVENT FLAG, 4-58 
Summary, 4-1 
SUSPEND, 4-51 
TASK EXIT, 4-23 
UNMAP ADDRESS WINDOW, 4-6 
UNSTOP TASK, 4-61 
unsupported, 4-1 
VAX/VMS handling, 4-1 
WAIT FOR LOGICAL OR OF EVENT 
FLAGS, 4-64 
WAIT FOR SIGNIFICANT EVENT, 2-7, 
4-63 
WAIT FOR SINGLE EVENT FLAG, 4-65 
DISABLE AST RECOGNITION 
directive, 4-17 
DISABLE CHECKPOINTING directive, 
2-6, 4-18 
Disassociate Common Event Flag 
Cluster system service, 4-19 
Disk 
ACP, 5-23 
driver, 5-8 
Driver 
card reader, 5-22 
disk, 5-8 
1/0, 5-1 
line printer, 5-10 
magnetic tape, 5-9 
terminal, 5-12 . 
DSARSS macro, 4-17 
DSCPSS macro, 4-18 
DSW code, 2-5, 4-7 
DTRGS macro, 4-3 


E 


ELAWS macro, 4-3 
ELGFS macro, 4-19 
ELIMINATE ADDRESS WINDOW 
directive, 4-3 
ELIMINATE GROUP GLOBAL EVENT FLAGS 
directive, 4-19 
Emulation 
directive, 1-3 
floating-point, 1-2 
I/O, 5-1 
ENABLE AST RECOGNITION directive, 
4-20 
ENABLE CHECKPOINTING directive, 
2-6, 4-21 
ENARSS macro, 4-20 


ENCPSS macro, 4-21 
Error condition, 2-10 
Event flag 
Clear, 4-12 
clusters, 2-4 
common, 2-4, 4-42 to 4-43 
conversion, 2-4 
extended, 4-43 
group global, 4-14, 4-19, 4-43 
I/O, 4-35, 4-37 
local, 2-4, 4-42 to 4-43 
logical OR, 4-56, 4-64 
protection, 2-4 
read, 4-42 to 4-43 
RSXCOMEFN, 2-4 
set, 4-33, 4-48 to 4-49 
Single, 4-58, 4-65 
stop for OR, 4-56 
stop for single, 4-58 
wait for logical OR, 4-64 
wait for single, 4-65 
Significant, 2-7, 4-16 
system, 2-7 
Event-associated directives 
CANCEL MARK TIME REQUESTS, 4-13 
CLEAR EVENT FLAG, 4-12 
CREATE GROUP GLOBAL EVENT FLAGS, 
4-14 
DECLARE SIGNIFICANT EVENT, 4-16 
ELIMINATE GROUP GLOBAL EVENT 
FLAGS, 4-19 
EXIT IF, 4-22 
MARK TIME, 4-33 
READ ALL EVENT FLAGS, 4-42 
READ EXTENDED EVENT FLAGS, 4-43 
SET EVENT FLAG, 4-49 
WAIT FOR LOGICAL OR OF EVENT 
FLAGS, 4-64 
WAIT FOR SIGNIFICANT EVENT, 4-63 
WAIT FOR SINGLE EVENT FLAG, 4-65 
Exception handling, 2-10 
EXIFS macro, 4-22 
EXIT IF directive, 4-22 
Exit system service, 4-22 to 4-24, 
4-4] 
EXIT WITH STATUS directive, 4-24 
EXITSS macro, 4-23 
EXSTS macro, 4-24 
EXTEND TASK directive, 4-25 
Extended event flags, 4-43 
EXTKS macro, 4-25 


spooling, 3-11 
File 


identification block, 5-24 
operations, 5-23 
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File (Cont.) i 
specification, parsing, 2-12, 
B~] I/O 
File-structured devices, 5-23 ACP, 3-4 
Files-l1l ACP, 3-11 attach, 3-4, 5-2 
Floating-point block locking, 3-6 
AST, 4-50 cancel, 3-4, 5-3 
emulation, 1-2 card reader, 5-22 
instructions, 1-4 channel, 3-3, 4-10 
Force Exit system service, 4-8 detach, 5-2 
disk, 5-8 
driver, 3-4, 5-1 
G card reader, 5-22 
disk, 5-8 
Get Channel Information system line printer, 5-10 
service, 4-26 magnetic tape, 5-9 
Get Device Information system terminal, 5-12 
service, 3-4 emulation, 5-1 
GET LUN INFORMATION directive, function, 5-1 to 5-2 
3-4, 4-26, 5-2 interface to VAX/VMS, 3-4 
GET MAPPING CONTEXT directive, limits on resource usage, 2-2 
Aa9 line printer, 5-10 
GET MCR COMMAND LINE directive, HRN EES Cope 22 
4-28 null device, 5-23 
GET PARTITION PARAMETERS requests, 3-3, 3-8 
directive, 2-6, 4-30 resource usage limits, 2-2 
GET REGION PARAMETERS directive, return, 5-3 
4-4 status, pt 4-37 
GET SENSE SWITCHES directive, SEeLUS Peer 2 


system, 2-13, 3-1 


4-4 : 
: : system services -2 
GET TASK PARAMETERS directive, oat: ae 3 
4-32 ; F : 
: : If/O- and intertask communications-— 
GET TIME PARAMETERS directive, / Patated directives 


ASSIGN LUN, 4-10 

Get Time System service, 4-31 GET LUN INFORMATION, 4-26 
Global section, 2-8 GET MCR COMMAND LINE, 4-28 
GLUNS macro, 4-26 QUEUE I/O REQUEST, 4-35 


GMCRS macro, 4-28 QUEUE I/O REQUEST AND WAIT, 4-37 
GMXC$ macro, 4-3 RECEIVE DATA, 4-40 
GPRTS macro, 4-30 RECEIVE DATA OR EXIT, 4-41 
GREGS macro, 4-4 SEND DATA, 4-48 
Group (UIC), 2-1 IHARSS macro, 4-17 
Group global event flags, 4-14, Image, 1-5 
4-19 interface to VAX/VMS I/0, 3-4 
GSSWSS macro, 4-4 shareable, 2-7 
GTIMS macro, 4-31 termination, 2-10, 4-8, 4-22 to 
GTSKS macro, 4-32 4-24, 4-41 
Information 
device, 4-26, 5-2 
H event flags, 4-42 
logical unit, 4-26, 4-32 

HALT instruction, 1-2 mailbox, 4-26 
Handling partition, 4-30, 4-32 

directive, 4-1 priority, 4-32 

directives, 4-1 process, 4-32 
Handling exceptions, 2-10 SST vector table, 4-32 
Hibernate system service, 4-38, task, 4-32 

4-44 to 4-45, 4-51, 4-57 time parameters, 4-31 

Hibernation, 2-9 UIC, 2-2, 4-32 


Index-4 


INDEX 


Informational directives 
GET PARTITION PARAMETERS, 
GET TASK PARAMETERS, 4-32 
GET TIME PARAMETERS, 4-31 

INHIBIT AST RECOGNITION directive, 

4-17 

Installed global section, 

Installed task, 2-3 

Instruction 
compatibility, 1-1 
EMT377, 1-1 
floating-point, 1-2, 1-4 
HALT, 1-2 
RESET, 1-2 
set, compatibility, A-1 

Interprocess communication, 

3-10 
Invalid directives, 


4-30 


2=9 


3-9 to 


4-1 


L 


LB device, 3-8 

LIBR option, 2-9 

Library, 2-9 

Limits, resource usage, 2-2 

Line printer driver, 5-10 

Local event flags, 2-4 

Logical name, device, 

Logical unit, 
4-32 


4-10 
4-26 , 


3-7 ’ 
information, 


CRAWS, 4-2 
CRGFS, 4-14 
CRRGS$S, 4-2 
CSRO$, 4-15 
DECLSS, 4-16 
DIRS, B-1l 
DSARSS, 4-17 
DSCPSS, 4-18 
DTRGS, 4-3 
ELAWS, 4-3 
ELGFS, 4-19 
ENARSS, 4-20 
ENCPSS, 4-21 
EXIFS, 4-22 
EXITSS, 4-23 
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EXSTS, 4-24 

EXTKS, 4-25 

GLUNS, 4-28 

GMCRS, 4-28 

GMCXS, 4-3 

GPRTS, 4-30 

GREGS, 4-4 

GSSWSS, 4-4 

GRIMS, 4-31 

GTSKS$, 4-32 

IHARSS, 4-17 

MAPS, 4-4 

MRKTS, 4-33 

PRINTS, 3-11 

QIOS, 4-35 

QIOWS, 4-37 

RCSTS, 4-38 

RCVDS, 4-40 

RCVX$, 4-41 

RDAFS, 4-42 

RDXFS, 4-43 

ROSTS, 4-44 

RREFS, 4-45 

RSUMS, 4-45 

RSXDEFS, 2-11 

RUNS, 4-46 

SDATS, 4-48 

SETFS, 4-49 

SFPAS, 4-50 

SPNDSS, 4-51 

SPRAS, 4-52 

SPWNS, 4-53 

SRDAS, 4-54 

SREFS, 4-6 

SRRAS, 4-6 

STLOS, 4-56 

STOPSS, 4-57 

STSES, 4-58 

SVDBS, 4-59 

SVTKS, 4-60 

UMAPS, 4-6 

USTPS, 4-61 

WSIGSS, 4-63 

WTLOS, 4-64 

WTSES, 4-65 
Magnetic tape 

ACP, 5-23 

driver, 5-9 
Mailbox, 3-9 

create, 3-3, 3-9 to 3-10 

information, 4-26 

read from, 3-9 to 3-10, 4-38, 

4-40 to 4-41, 4-53 to 5-54 

send to, 3-9 to 3-10, 4-48, 4-53 
MAP ADDRESS WINDOW directive, 4-4 
MAPS macro, 4-4 
MARK TIME directive, 2-8, 
Mark time, cancel, 4-13 
MCR command line, 4-28 


4-33 
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Member (UIC), 2-1 
Memory management, 2-6 
MRKTS macro, 4-33 
Multiuser task 

image, 1-4 

name, 2-3 


N 


Name 
device, 3-4, 3-6 to 3-7, 
logical device, 3-7 
partition, 2-6, 4-32 
physical device, 4-10 
process, 2-3 to 2-4, 
task, 2-3 
Nonshareable device, 
Normal termination, 
Null device, 5-23 


O 


4-10 


4-32 
3-4, 5-3 
2210 


OV device, 3-8 
Overlays, 1-4 


p 


Paging, 2-7 
Parent/offspring tasking 
directives 
EXIT WITH STATUS, 4-24 
RECEIVE DATA OR STOP, 
SPAWN, 4-53 
STOP, 4-57 
STOP FOR LOGICAL OR OF EVENT 
FLAGS, 4-56 
STOP FOR SINGLE EVENT FLAG, 
UNSTOP TASK, 4-61 
Parsing file specifications, 
B-1 


4-38 


4-58 


2-12, 


Partition, 2-6 
information, 4-30 
name, 4-30, 4-32 


Physical device, 4-10 
conversion, 3-7 
information, 4-26 
name, 4-10 
queue, 4-35, 4-37 

PLAS directives, 1-4 

Power recovery AST, 

PRINTS macro, 3-11 

Priority 
process, 4-9 
software, 2-8 
swapping, 2-6 
task, 4-32 

Privilege, 2-1 


4-52 


Process 
detached, 2-9 
identification, 2-3 
information, 4-32 
name, 2-3 to 2-4, 
priority, 4-9 
protection, 2-1 
subprocess, 2-9, 
UIC, 4-32 
VAX/VMS, 1-5 
virtual address space, 1-5 
Processor mode, 1-1 
Program region, 1-5 
Programming environment, 1-6 
Protection, 3-9 
event flag, 2-4 
process, 2-1 
PRT... task, 3-11 


4-32 


4-53 


Q 


QIOS macro, 4-35 

QIOWS macro, 4-37 

QUEUE I/O REQUEST AND WAIT 
directive, 4-37 

Queue I/O Request and Wait for 
Event Flag system service, 
4-37 

QUEUE I/O REQUEST directive, 4-35 

Queue I/O Request system service, 
3-3, 4-35, 4-40 to 4-41, 4-48, 
5-1 


4-38 
4-40 
4-4] 


RCSTS macro, 
RCVDS$ macro, 
RCVXS macro, 
RDAFS macro, 4-42 
RDXFS$ macro, 4-43 
READ ALL EVENT FLAGS directive, 
4-42 
Read Event Flags system service, 
4-22, 4-42 to 4-43 
READ EXTENDED EVENT FLAGS 
directive, 4-43 
BECEINE BY REFERENCE directive, 
Receive data AST, 4-54 
RECEIVE DATA directive, 3-9, 4-40 
RECEIVE DATA OR EXIT directive, 
3-9, 4-41 
RECEIVE DATA OR STOP directive, 
4-38 
Record management service, 3-l 
Region 
control, 
program, 
shareable, 


1-5 
1-5 
La 
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REQUEST TASK directive, 4-44 
RESCOM option, 2-9 

RESET instruction, 1-2 

RESLIB option, 2-9 

Resource usage limits, 2-2 
RESUME TASK directive, 2-9, 4-45 
RMS, VAX/VMS, 3-1 

RSM-11, 3-6 

ROSTS$ macro, 4-44 

RSUMS macro, 4-45 

RSXCOMEFN cluster, 2-4 
RSXDEFS macro, 2-11 

RUN TASK directive, 2-8, 4-46 
RUNS macro, 4-46 


Ss 


Schedule Wakeup system service, 
4-46 

SDATS macro, 4-48 

SEND BY REFERENCE directive, 4-6, 

SEND DATA directive, 3-9, 3-1l, 
4-48 

Send Message to Symbiont Manager 
system service, 3-1l 

SET EVENT FLAG directive, 4-49 

Set Event Flag system service, 
4-49 

Set Power Recovery AST system 
service, 4-52 

Set Swap Mode system service, 
4-18, 4-21 

Set Timer system service, 4-33 

SETF$ macro, 4-49 

SFPAS macro, 4-50 

Shareable device, 3-4, 5-3 

Shareable image, 2-7 

Shareable region, 1-4 

Significant event, 2-7 

declare, 4-16 
wait for, 4-63 

SP device, 3-8 

SPAWN directive, 4-53 

SPECIFY FLOATING-POINT PROCESSOR 
EXCEPTION AST directive, 4-50 

SPECIFY POWER RECOVERY AST 
directive, 4-52 

SPECIFY RECEIVE-BY-REFERENCE AST 
directive, 4-6 

SPECIFY RECEIVE DATA AST 
directive, 4-54 

SPECIFY SST VECTOR TABLE FOR 
DEBUGGING AID directive, 4-59 

SPECIFY SST VECTOR TABLE FOR TASK 
directive, 4-60 

SPNDSS macro, 4-51 

Spooled devices, 3-11 

Spooling, FCS, 3-11 

SPRAS macro, 4-52 


SPWNS macro, 4-53 
SRDAS macro, 4-54 
SREFS macro, 4-5 to 4-6 
SRRAS macro, 4-6 
SST (synchronous system trap), 
2-11 
vector table 
information, 4-32 
specify, 4-59 to 4-60 
Status 
block, I/0, 5-3 
I/O, 4-35, 4-37 
STLOS macro, 4-56 
STOP directive, 4-57 
STOP FOR LOGICAL OR OF EVENT 
FLAGS directive, 4-56 
STOP FOR SINGLE EVENT FLAG 
directive, 4-58 
STOPSS macro, 4-57 
STSES macro, 4-58 
Subprocess, 2-4, 2-9, 4-53 
Supported devices, 5-2 
SUSPEND directive, 4-5l 
SVDBS macro, 4-59 
SVTKS macro, 4-60 
Swapping, 2-6 
disable, 4-18 
enable, 4-21 
SY device, 3-8 
Synchronous system trap (See SST) 
SYSSCOMMAND device, 3-8 
SYSSDISK device, 3-8 
SYSSERROR device, 3-8 
SYSSINPUT device, 3-8 
SYSSLIBRARY device, 2-9 
SYSSOUTPUT device, 3-8 
System 
clock, 2-8, 4-31 
environment, 1-6, 2-1 
status code, 4-7, 4-24 
System service 
Allocate Device, 3-4, 5-2 
Assign I/O Channel, 3-3, 4-10 
Associate Common Event Flag 
Cluster, 4-14 
Cancel I/O on Channel, 5-3 
Cancel I/O Request, 3-4 
Cancel Timer Request, 4-13 
Cancel Wakeup, 4-15 
Clear Event Flag, 4-12 
Create Mailbox and Assign I/O 
Channel, 3-3 
Disassociate Common Event Flag 
Cluster, 4-19 
Exit, 4-22 to 4-24, 4-41 
for I/O, 3-2 
Force Exit, 4-8 
Get Channel Information, 4-26 
Get Device Information, 3-4 
Get Time, 4-31 
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System service (Cont.) Termination (Cont. ) 
Hibernate, 4-38, 4-44 to 4-45, AST service routine, 4-11 
4-51, 4-57 code, 2-10 
Queue I/O Request, 3-3, 4-35, image, 2-10, 4-8, 4-22 to 4-24, 
4-40 to 4-41, 4-48, 5-1 4-41 
Queue I/O Request and Wait for normal, 2-10 
Event Flag, 4-37 task, 2-10, 4-8, 4-22 to 4-24, 
Read Event Flags, 4-22, 4-42 to 4-41 
4-43 TI device, 3-8 
Schedule Wakeup, 4-46 Time 
Send Message to Symbiont Manager, delay, 4-33, 4-46 
3-11 information, 4-31 
Set Event Flag, 4-49 Time-synchronized wakeup, cancel, 
Set Power Recovery AST, 4-52 4-15 
Set Swap Mode, 4-18, 4-21 Translate Logical Name system 
Set Timer, 4-33 service, 3-7 
Translate Logical Name, 3-7 Trap-associated directives 
Wait for Logical OR of Event AST SERVICE EXIT, 4-11 
Flags, 4-56, 4-58, 4-64 to DISABLE AST RECOGNITION, 4-17 
4-65 ENABLE AST RECOGNITION, 4-20 
Wake, 2-9, 4-44 to 4-46, 4-61 SPECIFY FLOATING-POINT PROCESSOR 


EXCEPTION AST, 4-50 
SPECIFY POWER RECOVERY AST, 4-52 


T SPECIFY RECEIVE DATA AST, 4-54 
SPECIFY SST VECTOR TABLE FOR 
Task DEBUGGING AID, 4-59 
execution control directives SPECIFY SST VECTOR TABLE FOR 
ABORT TASK, 4-8 TASK, 4-60 


CANCEL TIME BASED INITIATION 
REQUESTS, 4-15 


EXTEND TASK, 4-25 U 
REQUEST TASK, 4-44 
RESUME TASK, 4-45 UIC 
RUN TASK, 4-46 information, 2-2 
SUSPEND, 4-51 process, 2-1, 4-32 
TASK EXIT, 4-23 UMAPS macro, 4-6 
extend, 4-25 Unit, logical, 4-10, 4-26, 4-32 
hibernate, 4-38, 4-44 to 4-46, UNMAP ADDRESS WINDOW directive, 
4-57 4-6 
image, 1-5 UNSTOP TASK directive, 4-61 
installed, 2-3 Unsupported directives 
multiuser image, 1-4 ATTACH REGION, 4-2 
name, 2-3 CONNECT, 4-2 
parameters, 4-32 CONNECT TO INTERRUPT VECTOR, 4-2 
priority, 4-32 CREATE ADDRESS WINDOW, 4-2 
size, 4-25 CREATE REGION, 4-2 
SST vector table, 4-60 DETACH REGION, 4-3 
Status control directives ELIMINATE ADDRESS WINDOW, 4-3 
ALTER PRIORITY, 4-9 GET MAPPING CONTEXT, 4-3 
DISABLE CHECKPOINTING, 4-18 GET REGION PARAMETERS, 4-4 
ENABLE CHECKPOINTING, 4-21 GET SENSE SWITCHES, 4-4 
suspend, 2-9, 4-51 MAP ADDRESS WINDOW, 4-4 
terminate, 2-10, 4-8, 4-22 to RECEIVE BY REFERENCE, 4-5 
4-24, 4-41 SEND BY REFERENCE, 4-6 
wake, 2-9, 4-44 to 4-46, 4-61 SPECIFY RECEIVE-BY-REFERENCE 
TASK EXIT directive, 4-23 AST, 4-6 
Terminal driver, 5-12 UNMAP ADDRESS WINDOW, 4-6 
Termination User authorization file, 2-1 to 
abnormal, 2-10 2-2, 4-43 
AST, 4-53 USTPS macro, 4-61 
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V WAIT FOR SIGNIFICANT EVENT 
VAX-11 RMS, 3-1 directive, 2-7, 4-63 


Virtual address space, 1-5, 2-7 WAIT FOR SINGLE EVENT FLAG 
directive, 4-65 


W Wake system service, 2-9, 4-44 to 
4-46, 4-61 
WAIT FOR LOGICAL OR OF EVENT WK device, 3-8 


FLAGS, directive, 4-64 6 
Wait for Logical OR of Event WeTGye Wacrog S02 
Flags system service, 4-56, WTLOS macro, 4-64 
4-58, 4-64 to 4-65 WTSES macro, 4-65 
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READER'S COMMENTS 


This form is for document comments only. DIGITAL will 
use comments submitted on this form at the company's 
discretion. If you require a written reply and are 
eligible to receive one under Software Performance 
Report (SPR) service, submit your comments on an SPR 
form. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Did you find errors in this manual? If so, specify the error and the 
page number. 


Please indicate the type of reader that you most nearly represent. 


a es | 


Name 


Organization 


Street 


city. 


Assembly language programmer 
Higher-level language programmer 
Occasional programmer (experienced) 
User with little programming experience 
Student programmer 


Other (please specify) 


Date 





—.State__.. Zip Code 
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Country 
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